Skip to content

Last updated: 01 September 2026 | Change log

Payment Facilitator

Payment Facilitators provide payment services on behalf of their customers, including processing payments with Worldpay. In this model, the customers of a Payment Facilitator are sub-merchants. When a cardholder makes a purchase, the sub-merchant routes the transaction data to the Payment Facilitator, and the Payment Facilitator sends compliant payment transactions to Worldpay on behalf of the sub-merchant. Worldpay settles funds to the Payment Facilitator, who in turn pays out to their sub-merchants.

All Payment Facilitators must supply additional transaction information which clearly identifies both the Payment Facilitator and the sub-merchant involved.

How to enable

Using the merchant.paymentFacilitator object and providing all the required details related to the sub-merchant.

paymentFacilitator object (Required)

"merchant": {
  ....
    "paymentFacilitator": {
      "schemeId": "12345",                         
      "independentSalesOrganizationId": "12345",        
      "subMerchant": {                             
        "name": "Sub-Merchant Plc",                    
        "reference": "12345",                      
        "address": {                               
          "postalCode": "SW1 1AA",                 
          "street": "Regent Street",               
          "city": "London",                        
          "countryCode": "GB",                     
          "state": "CA"
        },
        "taxReference": "12345",
        "phoneNumber": "0123456789",
        "email": "test@email.com"
      }
    },
  ....
}

Schema

schemeIdstring, [ 1 .. 11 ] characters[0-9]*$required

Your payment facilitator ID received from Mastercard, Visa and Amex.

Example:"12345678901"
independentSalesOrganizationIdstring, [ 1 .. 11 ] characters[0-9]*$

Independent Sales Organization (ISO) ID provided by Mastercard.

Example:"12345678901"
subMerchantobjectrequired

Your sub-merchant's details.

Outcome details

The payment response does not include any paymentFacilitator specific information.