KashierDevelopersKashier Developers
API reference and playgroundPayouts

Get transfer by merchant transfer id

curl -X GET "https://test-api.kashier.io/v2/transfers/merchant-transfer-id/string"
{  "transferId": "TRS-1007931100",  "merchantTransferId": "transfer12349",  "recipientName": "Ahmed Mohamed",  "recipientNumber": "1012345678",  "recipientBank": "CIB",  "amount": 100,  "method": "bank",  "status": "TRANSFERRED",  "createdAt": "2026-06-18 10:30:00+00:00",  "updatedAt": "2026-06-18 11:45:00+00:00"}

Retrieves a payout transfer using the merchantTransferId your own systems assigned to it, so you can reconcile against your records without having to store Kashier's transferId. merchantTransferId is unique per merchant.

Authorization

secretKey
Authorization<token>

Merchant secret key used to identify the merchant, obtained from Kashier's dashboard. Pass the raw secret key value in the Authorization header (NOT a "Bearer" token).

In: header

Path Parameters

merchantTransferId*string

The unique identifier your systems assigned to the transfer.

Response Body

application/json

application/json

application/json

application/json

application/json

GET
/v2/transfers/merchant-transfer-id/{merchantTransferId}

Get payout batch details GET

Retrieves one payout batch together with the transfers it contains, paginated. Use it to find which rows of a bulk payout failed and why.

List beneficiaries GET

Retrieves your saved beneficiaries, paginated. type=beneficiary is required — the same route serves customers, and the parameter is what separates them.