Split Payments

Last changes: 10-28-2022

"Split Payment" is the Splitting of a Deposit Amount to multiple (2 or more) different Merchant Accounts.
The Deposit can be a Guest Payment or a Technical Account Payments, and it's Status must be "Captured".

The "Split Payment" will only become Booked to the Merchant Account once the "Captured" Deposit does.

Create the Split Payments

We use a Guest Payment directed to the "Transition Account", with a "Captured" Amount of 50.00 EUR and Transaction Reference "q1W2e3E4t5Y6u7I8o9P0". The Amount will be split between the "1st Merchant" and the "2nd Merchant".

Of the 50.00 EUR directed to the Transition Account (the "TRANSITION-DE-0000" Account) we forward 20.00 EUR to the 1st Merchant (the "MERCHANT-DE-1111" Account) using the 1.121 KC-Debit Account API method.

KC-Debit Account Request

Path:

PUT {baseURL}/payment/kc-debitAccount

Header:

Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: eyJhbGciOiJSUzI1NiI{abbreviated}RW5kVG9rZW4=

{
  "partnerReference": "DEV-SVR001-DE_SPLIT-PAY-TRA-001",
  "depositReference": "q1W2e3E4t5Y6u7I8o9P0",
  "merchantProgramCode": "ACMEPROG",
  "merchantAccno": "MERCHANT-DE-1111",
  "programAccno": "1234567890",
  "accno": "TRANSITION-DE-0000",
  "accnoType": "00",
  "paymentAmount": 20.00,
  "paymentCurrCode": "EUR",
  "paymentUsage": "Split-Pay-Transition-001",
  "useDifferentBillingAddress": false,
  "localDate": "2019-12-31",
  "localTime": "235959"
}

KC-Debit Account Response

Status Code:

200 (OK)

Header:

Content-Type: application/json
Accept-Language: en-US

{
  "uniqueReference": "a1B2c3D4e5F6g7H8i9J0",
  "accno": "TRANSITION-DE-0000",
  "programAccno": "1234567890",
  "merchantAccno": "MERCHANT-DE-1111",
  "merchantProgramCode": "ACMEPROG"
  "paymentAmount": 20.00,
  "paymentCurrCode": "EUR",
  "paymentUsage": "Split-Pay-Transition-001",
  "fxRate": 1.0,
  "statusCode": "CAPTURED",
  "partnerReference": "DEV-SVR001-DE_SPLIT-PAY-TRA-001",
  "localDate": "2019-12-31",
  "localTime": "235959",
  "sysDate": "2019-12-31",
  "sysTime": "225959",
  "responseCode": "0000",
  "responseDescription": "Successful execution.",
    "additionalInformation": {
        "requestId": "aff2728481a181dc36daedc14055b516"
    }
}

With 30.00 EUR remaining to the Transition Account (20.00 EUR already forwarded to the 1st Merchant) we can forward this amount to the 2nd Merchant (the "MERCHANT-DE-2222" Account).

KC-Debit Account Request

Path:

PUT {baseURL}/payment/kc-debitAccount

Header:

Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: eyJhbGciOiJSUzI1NiI{abbreviated}RW5kVG9rZW4=

{
  "partnerReference": "DEV-SVR001-DE_SPLIT-PAY-TRA-002",
  "depositReference": "q1W2e3E4t5Y6u7I8o9P0",
  "merchantProgramCode": "ACMEPROG",
  "merchantAccno": "MERCHANT-DE-2222",
  "programAccno": "1234567890",
  "accno": "TRANSITION-DE-0000",
  "accnoType": "00",
  "paymentAmount": 30.00,
  "paymentCurrCode": "EUR",
  "paymentUsage": "Split-Pay-Transition-002",
  "useDifferentBillingAddress": false,
  "localDate": "2019-12-31",
  "localTime": "235959"
}

KC-Debit Account Response

Status Code:

200 (OK)

Header:

Content-Type: application/json
Accept-Language: en-US

{
  "uniqueReference": "q1A2z3W4s5X6e7D8c9R0",
  "accno": "TRANSITION-DE-0000",
  "programAccno": "1234567890",
  "merchantAccno": "MERCHANT-DE-2222",
  "merchantProgramCode": "ACMEPROG"
  "paymentAmount": 30.00,
  "paymentCurrCode": "EUR",
  "paymentUsage": "Split-Pay-Transition-002",
  "fxRate": 1.0,
  "statusCode": "CAPTURED",
  "partnerReference": "DEV-SVR001-DE_SPLIT-PAY-TRA-002",
  "localDate": "2019-12-31",
  "localTime": "235959",
  "sysDate": "2019-12-31",
  "sysTime": "225959",
  "responseCode": "0000",
  "responseDescription": "Successful execution.",
    "additionalInformation": {
        "requestId": "aff2728481a181dc36daedc14055b516"
    }
}

Previous

Next