Skip to main content
POST
Create Payout
Initiate a payout to a mobile money account or bank account. Funds are deducted from your merchant wallet.

Endpoint

POST https://quickei.io/pay/sandbox/api/v1/payouts

Authentication

HTTP Basic Authentication using your client_id and client_secret.

Parameters

number
required
Amount to send. Must be greater than 0.
string
required
ISO 4217 currency code (3 characters, e.g. XAF, XOF, EUR). Must match an active wallet.
object
required
Recipient details. Structure depends on the payout type.For mobile money:For bank transfer:
string
required
Your internal reference. Must be unique per merchant (max 255 chars).
string
Description of the payout (max 500 chars).
string
Unique key to prevent duplicate payouts (max 64 chars).

Fees

A fee of 2% is applied to each payout, with a minimum of 100 XAF (or equivalent in the payout currency). The fee is deducted from your wallet on top of the payout amount.

Example Request

Success Response 200

Payout Statuses

Error Responses

400 Validation Error

422 Insufficient Balance

409 Duplicate Reference