Payouts
Create payout request
The API supports multiple payouts in a payout request. For multiple payouts, include them in the same payout request rather than creating a payout request for each.
For more information, see the documentation, and for sample calls, see the public Postman collection.
post/merchants/{merchantId}/payouts
Path parameters
merchantIdstring required
A unique merchant ID provided by Peach Payments in hexadecimal format.
Example:d0bf5a6a909111f0aabf02d14af18cff
A unique merchant ID provided by Peach Payments.
Request body
Example request
{
"payouts": [
{
"payoutId": "4eef2b5d-8bb2-41bf-425d-8f656e029f3f",
"bankName": "OLD MUTUAL BANK",
"accountNumber": "62007338991",
"branchCode": "250655",
"amount": 3312412,
"currency": "ZAR",
"accountHolder": "Elize Oliphant",
"reference": "Salary for June",
"payoutMethod": "realtime-eft"
}
]
}Response
Created or requested.
Example response
{
"payoutRequestId": "6e029f3f-21bf-425d-8f65-4eef2b5d8bb2",
"created": "2024-03-14T22:00:00.000Z",
"payouts": [
{
"bankName": "ABSA",
"accountNumber": "4047594620",
"branchCode": "632005",
"amount": 56712,
"currency": "ZAR",
"accountHolder": "Sibusiso Kumalo",
"reference": "Refund order 74152",
"payoutMethod": "realtime-eft",
"status": "successful",
"payoutId": "84920878-fc32-494f-8e30-6a2465c9a456",
"lastUpdated": "2024-03-14T22:00:00.000Z",
"created": "2024-03-14T22:00:00.000Z",
"resultCode": "2000.000.000",
"payoutPartnerRespondedAt": "2024-03-14T22:10:00.000Z"
},
{
"bankName": "NEDBANK",
"accountNumber": "1006393099",
"branchCode": "210002",
"amount": 78652,
"currency": "ZAR",
"accountHolder": "Thembisile Msibi",
"reference": "Refund order 98767",
"payoutMethod": "realtime-eft",
"status": "failed",
"payoutId": "355f5577-e174-4397-b8f6-ced4a7165217",
"lastUpdated": "2024-03-14T22:00:00.000Z",
"created": "2024-03-14T22:00:00.000Z",
"resultCode": "2001.003.109",
"payoutPartnerRespondedAt": "2024-03-14T22:10:00.000Z",
"error": {
"title": "Invalid input error",
"message": "There is no account associated with the account number you entered. Double-check your input and try again.",
"code": "2001.003.109"
}
}
]
}