Payment Facilitator
This guide includes fields for Payment Facilitator (PFAC) Single and Multi MID model, so that you can submit this data within the transaction request and you do not need to get all your sub-merchants boarded to our Gateway upfront.
Please note, that this implementation is not certified with all authorization protocols Gateway supports, please reach out to your support team to verify, if this functionality is available for you.
The transaction will be flagged as PFAC transaction in certified authorisation protocols.
Transaction Initiated from Master-store
After your master-store (PFAC store) has been boarded as Single or Multi MID, you will be able to initiate a transaction including sub-merchant data without the need to store and board sub-merchant data in our Gateway.
The following XML document represents an example of a request including minimal set of elements:
<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns4:IPGApiOrderRequest
xmlns:ns4="http://ipg-online.com/ipgapi/schemas/ipgapi"
xmlns:ns2="http://ipg-online.com/ipgapi/schemas/a1"
xmlns:ns3="http://ipg-online.com/ipgapi/schemas/v1">
<ns3:Transaction>
<ns3:CreditCardTxType>
<ns3:StoreId>230000001</ns3:StoreId>
<ns3:Type>Sale</ns3:Type>
</ns3:CreditCardTxType>
<ns3:CreditCardData>
<ns3:CardNumber>539909XXXXXX3166</ns3:CardNumber>
<ns3:ExpMonth>06</ns3:ExpMonth>
<ns3:ExpYear>29</ns3:ExpYear>
<ns3:CardCodeValue>XXX</ns3:CardCodeValue>
</ns3:CreditCardData>
<ns3:SubMerchant>
<ns3:Mcc>5734</ns3:Mcc>
<ns3:LegalName>Masterstore.com</ns3:LegalName>
<ns3:Address>
<ns3:Address1>Pr. Hendriklaan 26 II</ns3:Address1>
<ns3:Zip>1075 BD</ns3:Zip>
<ns3:City>AMSTERDAM</ns3:City>
<ns3:Country>NLD</ns3:Country>
</ns3:Address>
<ns3:MerchantID>123456789012345</ns3:MerchantID>
</ns3:SubMerchant>
<ns3:Payment>
<ns3:ChargeTotal>3.00</ns3:ChargeTotal>
<ns3:Currency>EUR</ns3:Currency>
</ns3:Payment>
</ns3:Transaction>
</ns4:IPGApiOrderRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Additionally, you send the following fields under SubMerchantData:
| Field | Presence | Description |
|---|---|---|
nationalTaxID | O | (available soon) Tax Identification Number (TINs), e.g. SIRET for France, Brazilian CNPJ, etc. |
valueAddedTaxID | O | (available soon) Value-added tax identification number |
Evaluation of tax IDs before sending to VISA network
By applying the Merchant Identification Number to Visa, the gateway will evaluate the sub fields of
SubMerchantDatain the following way:
- merchant located in FRA: only use National Tax ID
- merchant located in BEL: National Tax ID if exists, otherwise Value Added Tax ID
- merchant located in LUX: National Tax ID if exists, otherwise Value Added Tax ID
Updated 23 days ago
