Payment Facilitator

Transaction initiated from Master-store

Within the Payment Facilitator (PFAC) model, the Hosted Payment Page (Connect) allows starting transactions by a sub merchant. We highly recommend to check with your integration or 2nd level support team, if your store is eligible to use this functionality before proceeding with the implementation.

Once your store has been configured in our Gateway and flagged as PFAC master store, you can send a transaction request on behalf of your sub stores to the Gateway including the sub merchant data.

It contains the following elements:

Field NameM/O/CDescription
sharedsecretMShared secret from PFACmaster store
subMerchantMCCMMerchant Category Code of a sub-merchant
subMerchantLegalNameMOfficial legal name of a sub-merchant
subMerchantAddr1MSub-merchant address line 1
subMerchantAddr2OSub-merchant address line 2
subMerchantZipMSub-merchant ZIP code
subMerchantCityMSub-merchant city
subMerchantStateCSub-merchant state or region
Note: some schemes may require full address details including a parameter region, submitted as 2 or 3 digits ISO code
subMerchantCountryMSub-merchant country in 2 or 3 digits ISO code
subMerchantIdMRepresents sub-merchant's ID assigned by their payment facilitator
subMerchantDocTypeODocument information. Ignored by the Gateway for now.
subMerchantDocNumberODocument information. Ignored by the Gateway for now.
subMerchantEmailOSub-merchant email
subMerchantTimezoneOA time zone a sub-merchant is operating in
subMerchantCompanyNameOSub-merchant company name
subMerchantVerificationValueOVisa Merchant Verification Value or MasterCard Assigned ID of sub-merchant

Transaction initiated from Sub-store

In case you preferred to board all your sub-merchants in our Gateway and your stores have been setup properly, you do not need to include any additional details when initiating a transaction request from a sub-store. The Gateway will provide all necessary flagging according your sub-store configuration.


Want a quick overview?