Setting up Split Remittance
- 07 Dec 2023
- 2 Minutes to read
- Print
- DarkLight
Setting up Split Remittance
- Updated on 07 Dec 2023
- 2 Minutes to read
- Print
- DarkLight
Article Summary
Share feedback
Thanks for sharing your feedback!
Evolve Split Remittance
In order to enable split remittance, you need a ‘supplier’ bank account, this account is linked to the merchant accounts that you want to use split remittance. Contact support who can arrange for the ‘supplier’ account to be created.
Obtaining the supplier bank account details
When onboarding a new merchant, you will need to link the ‘supplier’ bank account to each of the merchants. First you need to obtain the details of the supplier bank account.
Send a Get Bank Accounts request for the ‘supplier’ account (the supplier merchantId will be communicated by Access Paysuite Support)
You only need to do this once (per environment) as the information will not change.
The sections you will need from the Get Bank Bank Accounts response to attach the supplier account to the merchant account are:
usages
accountHolder
sortCode
accountNumber
Example bank account response:
[
{
"id": "4c4ea7e1-be81-494a-a8f1-f8a6c3154e86",
"merchantId": "11002394",
"status": "VERIFIED",
"usages": [
"REMITTANCE"
],
"merchantOwned": true,
"accountHolder": "Demo Supplier",
"sortCode": "089000",
"accountNumber": "04767832",
"lastStatusChangeAt": "2021-07-16T10:59:14.29Z",
"signatories": [
{
"firstName": "Bobby",
"lastName": "Test",
"status": "ACTIVE"
}
]
}
] Connect supplier bank account to merchant account
Create a new merchant bank account using the Create Bank Account
Set merchantOwned=false
Use the below for the supplier bank account
usages
accountHolder
sortCode
accountNumber
{{merchantId}} is the merchantId of the merchant who is being onboarded.
This will link the ‘supplier’ bank account to the merchant.
Example add bank account request:
{
"merchantId": "{{merchantId}}",
"usages": [
"REMITTANCE"
],
"merchantOwned": false,
"accountHolder": "Demo Supplier",
"sortCode": "089000",
"accountNumber": "04767832"
}
Store bank account IDs
Bank account IDs are used in the payment request to specify the bank account to be used. They are available from the create bank account response, or send a Get Bank Accounts request for the merchant using their merchantId.
The key attribute to distinguish merchant and supplier bank account in the response is merchantOwned; this will be true for the merchant’s own bank account and false for supplier bank account.
[
{
"id": "aefa4e01-d5b0-4bda-b90e-df4d06dabe63",
"merchantId": "10000474",
"status": "VERIFIED",
"usages": [
"REMITTANCE"
],
"merchantOwned": false,
"accountHolder": "Demo Onboarding Merchant",
"sortCode": "089000",
"accountNumber": "04767832",
"thirdPartyBankAccount": {
"merchantId": "11002394",
"accountId": "4c4ea7e1-be81-494a-a8f1-f8a6c3154e86"
},
"lastStatusChangeAt": "2021-07-16T12:28:00.639Z"
},
{
{
"id": "cf13a0ce-7999-4e26-8d48-32d8077dc0f1",
"merchantId": "10000474",
"status": "VERIFIED",
"usages": [
"REMITTANCE"
],
"merchantOwned": true,
"accountHolder": "Phil Wathan",
"sortCode": "100000",
"accountNumber": "10000119",
"lastStatusChangeAt": "2021-02-10T14:57:52.342Z",
"signatories": [
{
"firstName": " Bill",
"lastName": "Jones",
"status": "ACTIVE"
}
]
}
Was this article helpful?