v1
latestOpenAPI 3.1.02026-07-26850209.3 KB越南盾代收申请
appId需使用越南盾对应的,用户支付成功后增加越南盾余额
post/vnd/collect/apply
Request body
appIdinteger required
业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdstring required
商户订单号(必须保证唯一性,长度不超过48)
namestring required
付款人姓名(付款人姓名格式:英文或越南语大小写且允许有空格,1-30位,"firstName middleName lastName" (middleName非必填,特殊字符支持!-)
outBankNostring
付款人卡号, payType为 PAYMENT_GATEWAY时必填
phonestring required
真实手机号
emailstring email required
真实电子邮件
amountstring required
交易金额(单位:₫,越南盾) 范围:100,000-10,000,000 金额需要是100的倍数
payType'QR' | 'PAYMENT_GATEWAY' | 'BANK_TRANSFER' | 'EWALLET' required
交易类型:QR,PAYMENT_GATEWAY,BANK_TRANSFER,EWALLET
inBankCodestring
支付方式,当payType=EWALLET时,支持传MOMO_VND,代表跳转MoMo钱包支付
callBackUrlstring uri required
用户支付成功后跳转地址
callBackFailUrlstring uri required
用户支付失败后跳转地址
notifyUrlstring uri
回调地址
currency'USD' | 'VND'
币种(默认VND 支持下单币种: USD,VND)
subjectstring
支付备注
bodystring
备注详情
partnerUserIdstring required
用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。
signstring required
签名
Response
statusstring
状态码
errorstring
错误码
msgstring
消息描述