创建收款单（越南）

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

请求资讯

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

请求参数

参数名	必选	类型	说明
platform_id	是	String(6)	商户 ID
service_id	是	String(7)	服务 ID
payment_cl_id	是	String(64)	商户订单号
amount	是	Integer(10)	金额（分）
notify_url	是	String(256)	交易结果通知地址
request_time	是	Integer(10)	请求时间（秒）
sign_type	否	String(16)	签名类型，固定值 HMAC-SHA256
sign	是	String(32|64)	订单签名

请求示例

{
  "amount": "50000000",
  "notify_url": "https://xxx.xx/notification",
  "payment_cl_id": "DEVPM00014581",
  "platform_id": "PF0002",
  "request_time": "1595504136",
  "service_id": "SVC0015",
  "sign": "c81634c1769044eac9e9628a2292f557"
}

返回示例

成功返回

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 5001000,
    "qr_code_content": "00020101021238600010A000000727013000069704480",
    "token": "fabdzannfa",
    "card_name": "NGUYEN VAN A",
    "card_number": "0110100007725008", 
    "bank_name": "Asia Commercial Bank"
  }
}

错误返回示例

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

返回参数说明

参数名	类型	说明
error_code	String	错误码，详见全局错误码
error_msg	String	错误讯息（error_code 不为 "0000" 时返回）
link	String	订单收银台地址
payment_id	String	平台订单号
payment_cl_id	String	商户订单号
amount	Int	提单金额
token	String	转帐附言
qr_code_content	String	qr code 内容
card_name	String	收款账户名
card_number	String	收款银行卡号
bank_name	String	收款银行名称
payment_cl_name	String	付款人姓名，即建单传入的 name 原样回带；越南地区服务不使用此参数，固定为空字符串

备注

• 商户 ID 为系统分配之唯一识别，如尚未取得请联系系统人员
• 服务 ID 请填入：
  • SVC0015 银行卡（越南通道）
  • SVC0016 银行直连（越南通道）
  • SVC0017 QR 扫码（越南通道）
  • 参考 service_id 列表
• 交易金额单位为越南盾（分），请乘以 100 传入，例如收款 10000.00 请传值 1000000
• 请求时间使用 Unix timestamp，单位为秒
• 交易结果将通知至 notify_url，请传入可公开访问之完整地址（仅支援 http 与 https 协议），参数规范见 交易结果通知