Skip to main content
POST
Bank Payout

Overview

The Bank Payout API allows you to transfer funds directly to a recipient’s bank account. Use the preview endpoint to see fee breakdowns, initiate to execute the transfer, and list to retrieve past bank payouts.
Bank payout is currently restricted to 1,000,000 TZS in a single transaction

Request Headers

string
required
Bearer token for authentication. Format: Bearer <token>
string
default:"application/json"
Expected response format. Use application/json.
string
default:"application/json"
Format of the request body. Use application/json.
string
required
A unique key to ensure idempotent requests.

Preview Bank Payout

Calculate fees and validate recipient details before committing.

Request Body

integer
required
Amount to send in the specified currency
string
required
Currency code (e.g., TZS)
string
required
Recipient’s bank account number
string
required
Bank Identifier Code (BIC/SWIFT) of the destination bank
object
required
Recipient details
object
Arbitrary key-value pairs for your reference. Maximum of 3 items, each less than 100 characters.

Example Request


Initiate Bank Payout

Execute the bank transfer.

Request Body

Same fields as the preview endpoint.

Response

boolean
Indicates whether the bank payout was successful.
string
Human-readable status message.
object
Updated account balance after the payout.
string
Unique identifier for the transaction.
string
Current status of the payout. Example: initiated.
object
Details about the payout amount.
object
Bank account details used for the payout.
object
Additional metadata attached to the payout.
Always run a preview before initiating a bank payout to validate the BIC and account number are correct.