Payout

Create a Pakistan payout order to transfer funds to the recipient account.

POST/api/v2/payout/create

Use this endpoint to submit a payout order and receive the initial platform acceptance result.

Request Headers

x-access-keystringRequired

Merchant access identifier

signaturestringRequired

Request signature

Request Parameters

timestampstringRequired

Millisecond timestamp string, for example 1715941383720

merchantOrderNostringRequired

Unique identifier. Recommended format: YYYYMMDDHHMMSS + random number

orderAmountstringRequired

Payment amount. Minimum amount is 1 PKR

customerNamestringRequired

Payer name

customerEmailstringRequired

Recipient email

customerPhonestringRequired

Recipient mobile number

accountTypestringRequired

Recipient account type: BANK or WALLET

bankAccountNamestringRequired

When accountType=BANK, fill in the bank code from the supported bank list. When accountType=WALLET, fill in the wallet type code such as EASYPAISA or JAZZCASH. Real verification is required

bankAccountNostringRequired

When accountType=BANK, fill in the recipient bank account number. When accountType=WALLET, fill in the recipient wallet account number. Real verification is required

callbackUrlstringRequired

Async callback URL

Response Parameters

messagestringReturned

Request result. success only means the current API call succeeded and should not be used as the final business result

codestringReturned

Business status code. 00000 means the request was accepted. Other 5-digit values indicate specific error reasons; refer to the error code page

timestampstringReturned

Transaction timestamp

successbooleanReturned

API call result

dataobjectReturned

Response object

data.platformOrderNostringReturned

Unique platform order number

data.orderStatusstringReturned

Order status. SUCCESS means success, PENDING means processing, FAILED means failure, EXPIRED means expired, CANCELLED means cancelled, and REFUNDED means refunded

data.messagestringReturned

Status description message