Initiate Wallet Payout

Wallet Payout Request

Wallet Payout Request API

POST https://apisdbx.qwaap.com/v1/payout

Headers

Name	Type	Description
Content-Type*	String	application/json
public-key*	String	Obtained from merchant account settings
secret-key*	String	Obtained from merchant account settings

Request Body

Name	Type	Description
transaction_currency*	String	Currency in which transactions will be made
request_amount*	Int/Double	At most 2 decimal places allowed for double.
merchant_reference*	String	The UNIQUE reference for this transaction generated by your system. A unique string value should be sent for every attempt. 4 to 36 character
narration*	String	Use this to add a brief description or comment on the transaction. 4 to 64 character
transaction_method*	String	Can be MOBILE_MONEY or BANK
account_number*	String	Use phone number in international format. Takes bank account for BANK.
request_currency*	String	Currency of the request amount
recipient_name*	String	Actual names of the recipient
bank_code	String	Required for BANK
charge_customer	Boolean	False by default

401: Unauthorized

{
    "code": 401,
    "status": "error",
    "message": "Unauthorized API access. Unknown IP address 102.219.103.10",
    "data": {}
}

202: Accepted

{
    "code": 202,
    "status": "accepted",
    "message": "Your wallet withdraw of UGX 10,000 has been initiated. Standby for confirmation SMS",
    "data": {
        "request_id": 2885,
        "request_amount": 10000,
        "request_currency": "UGX",
        "rate": 1,
        "transaction_amount": 10000,
        "transaction_currency": "UGX",
        "transaction_charge": 1000,
        "wallet_amount": 11000,
        "provider_name": "MTN Mobile Money Uganda Limited",
        "transaction_status": "PENDING",
        "internal_reference": "QWAAPRHDXL5KHYLUKKB8Q"
    }
}