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

消息描述