请求代收

WARNING

必看：姓名+手机号+邮箱+金额为判定不同客户发起依据，所以建议商户对接中注意以下问题，否则容易产生风控误判。

1. 不建议姓名、手机号、邮箱都写死
2. 同一客户使用同一个姓名+手机号+邮箱

接口

POST /cashin/vn/order/create

请求头

名称	必填	示例	说明
Content-Type	是	application/json

请求参数

字段	类型	必填	说明
bankCode	string enum	是	银行编码 — 请查看BankCode编码章节 — UPI
amount	number	是	订单金额 — 最多小数点后两位，超过则四舍五入,带小数点的情况,注意如果是浮点型签名前的拼接中amount的值会省略小数点后末尾的0
notifyUrl	string	是	通知回调地址 — 测试环境上支持自动回调，请求参数手机尾号单数回调成功，手机号双数回调失败
name	string	是	客户名称 — 越真实，成功率越高，触发风控系数越低
phone	string	是	客户电话 — 以0开头，第二位数字为9，后跟8-9位数字的越南手机号，手机号格式，越真实，成功率越高，触发风控系数越低
email	string	是	客户邮箱 — 越真实，成功率越高，触发风控系数越低
sign	string	是	签名
appId	string	是	商户appId — 平台分配商户appId
mchOrderNo	string	是	商户订单号
mchId	integer	是	商户号
timestamp	integer	是	提交时间 — 秒级时间戳
txChannel	string	是	交易通道 — 固定值
returnUrl	string	否	收银台页面跳转地址
productInfo	string	是	产品信息

请求示例

{
  "mchId": 399204155797661,
  "txChannel": "TX_VN_001",
  "appId": "DFN19SJXfxFCexeLIi",
  "timestamp": 16624500121,
  "mchOrderNo": "order_1672451031",
  "bankCode": "MOMO",
  "amount": 5000,
  "name": "Timothy Gonzalez",
  "phone": "18688984423",
  "email": "w.gssdyohqr@chvro.cy",
  "productInfo": "xxx-Rechange",
  "notifyUrl": "http://wxyiwtonif.sj/vpuu",
  "returnUrl": "https://www.baidu.com/",
  "sign": "xxxxxxxx"
}

响应参数

字段	类型	必填	说明
status	integer	是	状态
msg	string	是	信息
data	object	是	数据
data.applyTime	integer	是	申请时间 — 时间戳格式
data.amount	number	是	实际支付金额
data.link	string	是	支付链接
data.expireTime	integer	是	过期时间 — 时间戳格式
data.mchOrderNo	string	是	商户订单号
data.platOrderNo	string	是	平台订单号
data.reference	string	是	参考码

响应示例

{
  "status": 200,
  "msg": null,
  "data": {
    "link": "https://s.xxxbxxxxxdpay.pw/pay/3661235101151a67b138e6a13049f782",
    "mchOrderNo": "php_1698144286763",
    "platOrderNo": "P_231024QiRN7KyNWTb0R7fWoVuN",
    "applyTime": 1698144286,
    "amount": 0,
    "reference": null,
    "expireTime": 1698144888
  }
}

相关文档

• 越南
• 签名与验签
• 代收 Webhook