2、Create Payment out

Used for merchants to initiate a payment request, and the system will transfer funds to the recipient's account.

Request Method

• POST

Request URL

/api/v3/vn/createTransferOrder

Request Type

Header: { 'Content-Type': 'application/json;charset=utf-8' }

Request Headers

Parameter Name	Description	Example Value
access_key	Obtained from the merchant's backend	pFqV75X3
timestamp	13-digit Unix timestamp (milliseconds)	1679724896223
nonce	UUID V4 format	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	Signature calculated based on signing rules	kAXyh+eerqrefyaF8dyFB0M4FVo=

Request Example:

{
    "currencyAmount":"10.00",
    "channelType":"BANK",
    "externalOrderId":"6554516461231233222222222",
    "accountId":"222333331",
    "accountName":"wsxtes",
    "bankName":"Techcombank",
    "remark":"adkasd",
    "notifyUrl":"https://platform.hambit.co/#/home/dashboard",
    "returnUrl":"https://platform.hambit.co/#/home/dashboard"

}

Request Parameter Description

Recommendation: To improve the efficiency of payment processing, it is recommended to provide all fields.

Parameter Name	Type	Required	Description
currencyAmount	String	Yes	Payout amount
channelType	String	Yes	Payment type (enum: BANK)
externalOrderId	String	Yes	Merchant order ID
accountName	String	Yes	Bank account holder name
accountId	String	Yes	Beneficiary account number
bankName	String	Yes	Bank name (abbreviation required)
remark	String	No	Transaction remarks
notifyUrl	String	No	Asynchronous notification callback URL (Public network address recommended)

Response Type

Header: { 'Content-Type': 'application/json;charset=utf-8' }

Response Example

{
    "code": "200",
    "success": true,
    "msg": "成功",
    "msgEn": "SUCCESS",
    "data": {
        "currencyType": "VND",
        "externalOrderId": "6554516461231233222222222",
        "orderId": "OCURRDRAW202402270637261709015846138DEV001OO0000000200013584",
        "orderStatus": "Accepted"
    }
}

Response Parameter Description

Parameter Name	Type	Description
orderId	String	System order ID
orderStatus	String	Order status
externalOrderId	String	Merchant order ID
currencyType	String	Currency type (e.g., INR)