Payout
Developing
POST
/gateway/base/biz
WALLET Payout Parameters
| Parameter Name | Parameter Type | Required | Example | |
|---|---|---|---|---|
| paymentType | Payment Type | String | required | WALLET |
| beneficiaryType | Beneficiary Account Type | String | required | PHONE / MEMBER |
| beneficiaryAccountNumber | Beneficiary Account | String | required | For PHONE type: enter phone number; for MEMBER type: enter member ID |
IBAN 出款参数
| Parameter Name | Parameter Type | Required | Example | |
|---|---|---|---|---|
| paymentType | Payment Type | String | required | IBAN |
| beneficiaryAccountType | Beneficiary Account Type | String | required | Personal / Company |
| companyName | Company Name | String | optional | Required if beneficiaryAccountType is Company |
| beneficiaryName | Beneficiary Account Name | String | required | |
| beneficiaryAccountNumber | Beneficiary Account Number | String | required | IBAN account |
| beneficiaryAddress | Beneficiary Bank Address | String | required | |
| beneficiaryBankName | Beneficiary Bank Name | String | required | |
| swiftCode | SWIFT Code | String | required |
paymentType List
| paymentType | beneficiaryType | Notes |
|---|---|---|
| WALLET | PHONE | BOTIM-linked mobile number: +971-5xxxxxxxx, 5xxxxxxxx, or 05xxxxxxxx are all acceptable |
| MEMBER | BOTIM member ID: 10001734xxx | |
| IBAN | - | IBAN account |
WALLET Payout Parameter Template
{
"amount": "10",
"currency": "AED",
"callbackUrl": "http://127.0.0.1:8082/india-merchant/core/callback",
"beneficiaryEmail": "muazpe@gmail.com",
"beneficiaryName": "SHUIPING Zhou",
"beneficiaryAccountNumber": "+971-565800009", //565800009
"beneficiaryAddress": "Liwa Street off Khaliffa Street",
"beneficiaryType": "PHONE",
"beneficiaryMobile": "+971-565800009",
"mchOrderId": "aedtest119142",
"paymentType": "WALLET"
}
IBAN Payout Parameter Template
{
"mchOrderId": "aedtest00941117",
"amount": "10",
"currency": "AED",
"callbackUrl": "http://127.0.0.1:8082/india-merchant/core/callback",
"beneficiaryEmail": "muazpe@gmail.com",
"beneficiaryMobile": "+971-565806000",
"beneficiaryAccountType": "Company", // If Company, companyName is required; If Personal, companyName is optional
"companyName": "Test Company",
"beneficiaryName": "Lucky Chou",
"beneficiaryAccountNumber": "AE450860000006791000000",
"beneficiaryAddress": "Etihad Airways Centre, Abu Dhabi, UAE",
"beneficiaryBankName": "Wio Bank PJSC",
"swiftCode": "WIOBAEADXXX",
"paymentType": "IBAN"
}
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://prod-cn.your-api-server.com/gateway/base/biz' \
--header 'method: payOut' \
--header 'signType: SHA512' \
--header 'serviceName: api.pay' \
--header 'mchId: 1416010331032883200' \
--header 'timestamp: 1631671670' \
--header 'sign: 32554324534545432543' \
--header 'Content-Type: application/json' \
--data-raw '{
"mchOrderId": "string",
"amount": "string",
"currency": "string",
"purpose": "string",
"beneficiaryName": "string",
"beneficiaryEmail": "string",
"beneficiaryMobile": "string",
"beneficiaryAccountNumber": "string",
"callbackUrl": "string",
"paymentType": "WALLET",
"beneficiaryType": "string",
"beneficiaryAccountType": "string",
"companyName": "string",
"beneficiaryAddress": "string",
"beneficiaryBankName": "string",
"swiftCode": "string"
}'Response Response Example
{
"resultCode": "78",
"errorCode": "59",
"errorMsg": null,
"data": [
{
"orderId": "2",
"currency": "mollit"
},
{
"orderId": "31",
"currency": "dolor labore"
},
{
"orderId": "56",
"currency": "exercitation veniam voluptate id"
}
],
"success": false
}Modified at 2025-10-26 18:43:48