| Key | Type | Format | CND | Legacy API parameter | Description | |
|---|---|---|---|---|---|---|
| 1 | subMerchantID | string | ans..15 | C | subMID | SubMerchantID assigned from the Payment Facilitator and provided in the request to identify its sub-merchants during transaction flow. Please clarify beforehand with Axepta Merchant Services team if this parameter is required for the respective processing Acquirer. |
| 2 | subMerchantName | string | ans..22 | C | subMIDName | Name of the SubMerchantID. Card schemes require this value to be populated in the below format: subMerchantName=payFacName*subMIDName (PF Name-Asterix-sub merchantName) Please clarify beforehand with Axepta Merchant Services team if this parameter is required for the respective processing Acquirer. |
| 3 | subMerchantCity | string | ans..13 | C | subMIDAddrCity | Town/city of the SubMerchantID Please clarify beforehand with Axepta Merchant Services team if this parameter is required for the respective processing Acquirer. |
| 4 | subMerchantCountry | string | a..2 | C | subMIDAddrCountryCode | Country code of the SubMerchantID according to ISO-3166-1, alphanumeric 2 chars Please clarify beforehand with Axepta Merchant Services team if this parameter is required for the respective processing Acquirer. |
| 5 | subMerchantStreet | string | ans..38 | C | subMIDAddrStreet | Street of the SubMerchantID Please clarify beforehand with Axepta Merchant Services team if this parameter is required for the respective processing Acquirer. |
| 6 | subMerchantZIP | string | ans..10 | C | subMIDAddrZip | Postcode of the SubMerchantID Please clarify beforehand with Axepta Merchant Services team if this parameter is required for the respective processing Acquirer. |
| 7 | subMerchantState | string | ans..3 | C | subMIDAddrState | Federal State of the SubMerchantID Please clarify beforehand with Axepta Merchant Services team if this parameter is required for the respective processing Acquirer. |
Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "http://json-schema.org/draft-07/schema#",
"title": "subMerchantPF",
"description": "Data related to a sub-Merchant entity as part of a Payment Facilitator Model",
"type": "object",
"properties": {
"subMerchantID": {
"type": "string",
"description": "SubMerchantID assigned from the Payment Facilitator"
},
"subMerchantName": {
"type": "string",
"description": "Card schemes require this value to be populated in the below format:'payFacName*subMIDName'.Payment Facilitator name must be represented within 3,7 or 12 characters"
},
"subMerchantCity": {
"type": "string",
"description": "Town/city of the SubMerchantID"
},
"subMerchantCountry": {
"type": "string",
"description": "Country code of the SubMerchantID according to ISO-3166-1, alphanumeric 2 chars"
},
"subMerchantStreet": {
"type": "string",
"description": "Street of the SubMerchantID"
},
"subMerchantZIP": {
"type": "string",
"description": "Postcode of the SubMerchantID"
},
"subMerchantState": {
"type": "string",
"description": "Federal State of the SubMerchantID"
}
},
"additionalProperties": false
}
Sample
{
"subMerchantID":"TESTSHOP33",
"subMerchantName":"PFNAMES*SHOPNAME",
"subMerchantCity":"Bamberg",
"subMerchantCountry":"DE",
"subMerchantStreet":"Abtsberg" ,
"subMerchantZIP":"96049" ,
"subMerchantState":"DEU"
}