Create bank payout | SenjaroPay Docs

curl -X POST https://api.senjaropay.com/senjaropay/merchant/cashout/api/transfer \
     -H "x-api-secret: <apiSecret>" \
     -H "x-idempotency-key: 7c9e6679-7425-40de-944b-e07fc1f90ae7" \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "amount": 10000,
  "currency": "TZS",
  "bank": "ABSA",
  "account": "0001234567",
  "name": "Test Customer"
}'

{
  "status": "success",
  "code": 200,
  "data": {
    "success": true,
    "withdrawal_id": "c4fbdacb-6ac4-4159-ad23-50286a001ba4",
    "transaction_reference": "WDMVTEJ1P9VXJ8",
    "amount": 10000,
    "fee": 500,
    "net_amount": 9500,
    "currency": "TZS",
    "payout_amount": 9500,
    "payout_currency": "TZS",
    "fx_rate": null,
    "balance": {
      "currency": "TZS",
      "collections": 50000,
      "bill_payments": 5000,
      "withdrawals": 20000,
      "international_transfers": 10000,
      "available": 15000
    },
    "status": "PROCESSING",
    "account_name": "Test Customer",
    "account": "0001234567",
    "bank": "ABSA"
  }
}

Sends a bank payout (cashout) from the merchant wallet. Currently for TZS bank transfers. Always send currency explicitly. x-idempotency-key is required. Generate a new UUID for each payout.

Authentication

x-api-keystring

Dashboard Public Key. Maps to x-api-key.

x-api-secretstring

Dashboard Secret Key. Maps to x-api-secret. Server-side only.

Request

This endpoint expects an object.

amountintegerRequired

Gross amount to debit from the merchant wallet, in major units.

currencyenumRequired

Wallet and payout currency. Bank payouts currently support TZS. Additional currencies (for example USD) will be documented when available.

Allowed values:

bankstringRequired

Bank shortcode, for example ABSA, CRDBBANK, NMB. Prefer the same value used at account-name lookup.

accountstringRequired

Beneficiary bank account number.

namestringRequired

Beneficiary name from account-name lookup.

Response

Payout accepted

statusstring

codeinteger

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

Authentication

Headers

Request

Response

Errors