跳转到主要内容
POST
/
vnd
/
collect
/
apply
越南盾代收申请
curl --request POST \
  --url https://uat-interface.haipay.asia/vnd/collect/apply \
  --header 'Content-Type: application/json' \
  --data '
{
  "appId": 123,
  "orderId": "<string>",
  "name": "<string>",
  "phone": "<string>",
  "email": "jsmith@example.com",
  "amount": "<string>",
  "payType": "QR",
  "callBackUrl": "<string>",
  "callBackFailUrl": "<string>",
  "partnerUserId": "<string>",
  "sign": "<string>",
  "outBankNo": "<string>",
  "inBankCode": "<string>",
  "notifyUrl": "<string>",
  "currency": "USD",
  "subject": "<string>",
  "body": "<string>"
}
'
{
  "status": "<string>",
  "error": "<string>",
  "msg": "<string>",
  "data": {
    "orderId": "<string>",
    "orderNo": "<string>",
    "payUrl": "<string>",
    "bankNo": "<string>",
    "bankCode": "<string>",
    "bankUserName": "<string>",
    "qrCode": "<string>",
    "sign": "<string>"
  }
}

密钥私钥(生成签名)

请求体

application/json
appId
integer
必填

业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)

orderId
string
必填

商户订单号(必须保证唯一性,长度不超过48)

Maximum string length: 48
name
string
必填

付款人姓名(付款人姓名格式:英文或越南语大小写且允许有空格,1-30位,"firstName middleName lastName" (middleName非必填,特殊字符支持!-)

Required string length: 1 - 30
Pattern: ^[A-Za-zÀ-ỹ\s!-]+$
phone
string
必填

真实手机号

email
string<email>
必填

真实电子邮件

amount
string
必填

交易金额(单位:₫,越南盾) 范围:100,000-10,000,000 金额需要是100的倍数

Pattern: ^(100000|100100|100200|...|10000000)$
payType
enum<string>
必填

交易类型:QR,PAYMENT_GATEWAY,BANK_TRANSFER,EWALLET

可用选项:
QR,
PAYMENT_GATEWAY,
BANK_TRANSFER,
EWALLET
callBackUrl
string<uri>
必填

用户支付成功后跳转地址

callBackFailUrl
string<uri>
必填

用户支付失败后跳转地址

partnerUserId
string
必填

用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$
sign
string
必填

签名

outBankNo
string

付款人卡号, payType为 PAYMENT_GATEWAY时必填

inBankCode
string

支付方式,当payType=EWALLET时,支持传MOMO_VND,代表跳转MoMo钱包支付

notifyUrl
string<uri>

回调地址

currency
enum<string>

币种(默认VND 支持下单币种: USD,VND)

可用选项:
USD,
VND
subject
string

支付备注

body
string

备注详情

响应

200 - application/json
status
string

状态码

error
string

错误码

msg
string

消息描述

data
object

响应数据对象

Last modified on April 10, 2026