Get marketplace setting
/marketplaces/{marketplaceId}/settingscurl -X GET https://api.tst.au.apgpay.dev/marketplaces/{marketplaceId}/settings \
-H "Authorization: Bearer $API_KEY"Return the defaults sub-merchants inherit, and the tax countries this marketplace can create them in. The defaults are absent where you may not read them, which is the same answer as having none.
Permissions
marketplaces:queryRequires the `query` action on `marketplaces` for the supplied runtime context
Path parameters
marketplaceIdstringResponses
The response is a typed union.
typetype = "MktpSettingsConfigured"The settings sub-merchants inherit where they have set none of their own. An absent field is left as it is.
typeenumrequiredMktpDefaultsAttributessettlementTypeMchtSettlementTypeNet rolls platform fees into each payout; Gross invoices them separately.
NetGrossUnknownbankAccountVerificationRequiredbooleanWhether a bank account must be verified before it can be used.
Example true
Which verification outcomes are accepted, and whether the outcome is returned to the caller.
typeenumrequiredMchtVerificationPolicyAttributesacceptarray of MchtVerificationOutcomeOutcomes that let the account be used. Anything else is refused. Failed and Unknown cannot be accepted and are ignored if sent: what happens when the bank cannot answer is the platform's decision, not a merchant's.
MatchPartialMatchNoMatchAccountClosedFailedUnknownincludeResultInResponsebooleanReturn the verification outcome to the caller. Off by default, because it is the bank's assessment of a person.
Example true
sourceVerificationEnabledbooleanAsk a payer to confirm a small debit before their source is used, 3DS's belt and braces.
Example true
supportedCustomerTypesarray of MchtCustomerTypeWhich kinds of customer sub-merchants sell to. At least one; sending an empty list is refused.
ConsumerOrganisationUnknownpayInFullMinimumMinorUnitsSmallest pay-in-full payment a sub-merchant checkout will accept, in the minor units of *that sub-merchant's* currency.
Example 1250
payInFullMaximumMinorUnitsLargest pay-in-full payment a sub-merchant checkout will accept, in the minor units of *that sub-merchant's* currency.
Example 1250
disputesWaivedbooleanDo not charge sub-merchants for disputes.
Example true
payoutPriorityinteger (int32)Higher values are paid out ahead of lower ones.
Example 10
showPlatformLogoInTermsbooleanShow the platform's logo on the terms page shown to payers. Stated positively the platform holds the negation.
Example true
showSavedPaymentMethodsInCheckoutbooleanOffer the payer their saved payment sources in the checkout.
Example true
showReferenceOrderIdToCustomerbooleanShow the sub-merchant's own order reference on communications to the payer. Stated positively.
Example true
emailPaymentReceiptbooleanEmail the payer a receipt when an order is paid.
Example true
emailPaymentFailurebooleanEmail the payer after a failed attempt.
Example true
offerGooglePaybooleanOffer Google Pay in sub-merchant checkouts. Stated positively the platform holds inhibitGooglePay.
Example true
allowCheckoutWithoutPayInFullbooleanLet sub-merchants configure a checkout that offers pay plans only, with no pay-in-full option.
Example true
manualPaymentsCardOnlybooleanAccept only cards on manually entered payments, no bank transfers or direct debits.
Example true
useMarketplaceReceivableAccountbooleanUse the marketplace's own receivable account for sub-merchant bank transfers, rather than giving each one its own.
Example true
payIdDomainstringDomain for the PayIDs issued to sub-merchants. Must already be a domain the platform holds proof of ownership for.
payoutChannelsarray of MktpPayoutChannelPayout channels to attempt, in order. Fast first is the usual arrangement.
StandardFastUnknownpayoutRemitterNamestringThe name shown as the remitter on sub-merchants' payouts.
Example Ada Lovelace
disbursementSourceAccountIdstringBank account disbursements are paid from, where it is not the platform's default.
taxCountriesarray of IsoCountryEvery tax country the marketplace can create sub-merchants in, and therefore has a template for.
AFAXALDZASADAOAIAQAG+239 moreShow fewer
AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, KH, CM, CA, CV, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CK, CR, CI, HR, CU, CW, CY, CZ, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MK, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, KP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, RE, RO, RU, RW, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, KR, SS, ES, LK, SD, SR, SJ, SZ, SE, CH, SY, TW, TJ, TZ, TH, CD, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, US, UM, UY, VI, UZ, VU, VA, VE, VN, WF, EH, YE, ZM, ZW
{
"type": "MktpSettingsConfigured",
"defaults": {
"type": "MktpDefaultsAttributes",
"settlementType": "Net",
"bankAccountVerificationRequired": true,
"bankAccountVerification": {
"type": "MchtVerificationPolicyAttributes",
"accept": [
"Match"
],
"includeResultInResponse": true
},
"sourceVerificationEnabled": true,
"supportedCustomerTypes": [
"Consumer"
],
"payInFullMinimum": 1250,
"payInFullMaximum": 1250,
"disputesWaived": true,
"payoutPriority": 10,
"showPlatformLogoInTerms": true,
"showSavedPaymentMethodsInCheckout": true,
"showReferenceOrderIdToCustomer": true,
"emailPaymentReceipt": true,
"emailPaymentFailure": true,
"offerGooglePay": true,
"allowCheckoutWithoutPayInFull": true,
"manualPaymentsCardOnly": true,
"useMarketplaceReceivableAccount": true,
"payIdDomain": "string",
"payoutChannels": [
"Standard"
],
"payoutRemitterName": "Ada Lovelace",
"disbursementSourceAccountId": "string"
},
"taxCountries": [
"AU"
]
}Error responses
statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}