2、创建代付

用于商户发起代付请求，系统将执行向收款方账户的转账。

请求方式

• Method: POST
• 请求 URL:/api/v3/vn/createTransferOrder

请求头 Header

Content-Type: application/json; charset=utf-8

请求头参数说明

参数名	类型	描述	示例值
access_key	String	商户后台获取的访问密钥	pFqV75X3
timestamp	int64	13 位毫秒时间戳	1679724896223
nonce	String	UUID V4 随机字符串	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	String	计算生成的签名值	kAXyh+eerqrefyaF8dyFB0M4FVo=

所有参数需放入 Header 中发送，签名生成请参考数据签名规范。

请求示例：

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

}

请求参数说明

建议：为提升代付处理效率，以下字段建议全部传入。

参数名	类型	是否必填	描述
currencyAmount	String	是	代付金额
channelType	String	是	支付类型，枚举值：BANK
externalOrderId	String	是	商户订单号
accountName	String	是	银行账号姓名
accountId	String	是	收款账号
bankName	String	是	银行名字 该字段传缩写
remark	String	否	交易备注
notifyUrl	String	否	异步通知回调地址（建议公网地址）

响应示例

响应 Header 类型

Content-Type: application/json; charset=utf-8

响应数据（成功）

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

响应字段说明

Param	Type	Desc
currencyType	String	法币类型
externalOrderId	String	商户订单 id
orderId	String	系统订单 ID
orderStatus	String	订单状态，正常返回“Accept”，后续通过查询/回调更新状态