Payout

Amount supports up to 2 decimal places

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

Example

{
    "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"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

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
}

WALLET Payout Parameters#

IBAN 出款参数#

paymentType List#

WALLET Payout Parameter Template#

IBAN Payout Parameter Template#