创建出款单（越南）

创建越南盾（VND）出款订单接口。

请求资讯

• 请求 URL： /gateway/api/v2/payouts
• 请求方式： POST
• Content-Type： application/json;charset=utf-8

请求参数

参数名	必选	类型	说明
platform_id	是	String(6)	商户 ID
service_id	是	String(7)	服务 ID
payout_cl_id	是	String(64)	商户订单号
amount	是	Integer(10)	金额（分）
notify_url	否	String(256)	交易结果通知地址
bank_name	是	String(16)	越南银行列表
name	是	String(16)	受款人户名
number	是	String(32)	受款人帐号
currency	是	String(3)	固定值：vnd
request_time	是	Integer(10)	请求时间（秒）
sign_type	否	String(16)	签名类型，固定值 HMAC-SHA256
sign	是	String(32|64)	订单签名

请求示例

{
  "amount": "50000",
  "bank_name": "ACB",
  "name": "test_name",
  "notify_url": "https://xxx.xx/notification",
  "number": "4088748280272397",
  "payout_cl_id": "DEVPOT00143538",
  "platform_id": "PF0002",
  "request_time": "1595504997",
  "service_id": "SVC0004",
  "sign": "8ac38fb87c2bcce4cf36627d4f8aa747"
}

返回示例

成功返回

{
  "error_code": "0000",
  "data": {
    "payout_id": "POT00000001"
  }
}

错误返回示例

{
  "error_code": "0004",
  "error_msg": "验签错误!"
}

返回参数说明

参数名	类型	说明
error_code	String	错误码，详见全局错误码
error_msg	String	错误讯息（error_code 不为 "0000" 时返回）
payout_id	String	平台订单号

备注

重要提示

因为存在网路波动、并发量过大、被攻击等不可抗力因素，如若在调用代付接口时遇到 超时、HTTP 500 错误、调用结果返回空白，或网路延迟时，请以 订单查询接口状态 为依据，或与运营人员取得联系，提供商户单号进行人工查询，由运营人员人工确认代付订单是否失败。 未经过运营人员人工确认就驳回代付订单所造成的损失，本平台概不负责！

• 商户 ID 为系统分配之唯一识别，如尚未取得请联系系统人员
• 服务 ID 请填入：
  • SVC0004（银行卡代付）
  • SVC0018（MOMO 代付）
  • SVC0047（ZALO 代付）
• 使用 SVC0018、SVC0047 时 bank_name 请填 "none"
• 交易金额单位为越南盾（分），请乘以 100 传入，例如收款 10000.00 请传值 1000000
• 请求时间使用 Unix timestamp，单位为秒
• 返回 "0000" 时仅代表接口调用成功，并不表示交易状态，请调用查询接口确认结果
• 如遇任何情况未取得 Server 回应（e.g. 5xx HttpStatus...），需调用查询接口或等待回调，不可直接视为订单失败