---
title: "越南盾代收申请"
method: POST
path: "/vnd/collect/apply"
---

# 越南盾代收申请

`POST /vnd/collect/apply`

appId需使用越南盾对应的，用户支付成功后增加越南盾余额

## Request body

- object
  - `appId` integer, required — 业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
  - `orderId` string, required — 商户订单号(必须保证唯一性，长度不超过48)
  - `name` string, required — 付款人姓名(付款人姓名格式:英文或越南语大小写且允许有空格,1-30位,"firstName middleName lastName" (middleName非必填,特殊字符支持!-)
  - `outBankNo` string — 付款人卡号, payType为 PAYMENT_GATEWAY时必填
  - `phone` string, required — 真实手机号
  - `email` string, email, required — 真实电子邮件
  - `amount` string, required — 交易金额(单位：₫，越南盾） 范围:100,000-10,000,000 金额需要是100的倍数
  - `payType` 'QR' | 'PAYMENT_GATEWAY' | 'BANK_TRANSFER' | 'EWALLET', required — 交易类型：QR，PAYMENT_GATEWAY,BANK_TRANSFER，EWALLET
  - `inBankCode` string — 支付方式，当payType=EWALLET时，支持传MOMO_VND，代表跳转MoMo钱包支付
  - `callBackUrl` string, uri, required — 用户支付成功后跳转地址
  - `callBackFailUrl` string, uri, required — 用户支付失败后跳转地址
  - `notifyUrl` string, uri — 回调地址
  - `currency` 'USD' | 'VND' — 币种(默认VND 支持下单币种: USD,VND)
  - `subject` string — 支付备注
  - `body` string — 备注详情
  - `partnerUserId` string, required — 用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。 格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
  - `sign` string, required — 签名

## Response `200`

- object
  - `status` string — 状态码
  - `error` string — 错误码
  - `msg` string — 消息描述
  - `data` object — 响应数据对象
    - `orderId` string — 商户订单号(必须保证唯一性)
    - `orderNo` string — 平台订单号
    - `payUrl` string — 返回的是收款地址 其他时候返回的是指引或者详情
    - `bankNo` string — 收款卡号(BANK_TRANSFER)
    - `bankCode` string — 收款银行
    - `bankUserName` string — 收款人姓名(BANK_TRANSFER)
    - `qrCode` string — 二维码内容-可自行生成二维码(QR)
    - `sign` string — 签名

---

[API](https://skmtc.net/haipay/apis/aed.md) · [All operations](https://skmtc.net/haipay/apis/aed/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/haipay/aed/versions/37b596150f0f/schema)