越南支付整合指南

本指南将帮助您在 5 分钟内完成越南盾（VND）支付系统 API 的基本整合。

前置准备

在开始之前，请确保您已经获得以下资讯：

项目	说明
platform_id	平台商户 ID
sign_key	平台密钥（用于签名）
authorization	授权识别码（用于请求头，部分 API 需要）
API 端点	测试/生产环境 URL

签名机制

所有 API 请求都需要包含 sign 参数。签名生成步骤：

1. 将所有非空参数按 ASCII 升序 排列
2. 使用 key=value 格式拼接，以 & 连接
3. 使用密钥进行 HMAC-SHA256 签名

详细说明请参考：签名规范

代收流程 (Deposit)

创建代收订单

curl -X POST https://api.your-domain.com/gateway/api/v1/payments \
  -H "Content-Type: application/json" \
  -d '{
    "platform_id": "your_platform_id",
    "service_id": "SVC0015",
    "payment_cl_id": "ORDER_12345",
    "amount": 5000000,
    "notify_url": "https://your-domain.com/callback",
    "request_time": 1595504136,
    "sign": "your_calculated_sign"
  }'

💡 注意：金额单位为越南盾（分），请乘以 100 传入。例如收款 50,000.00 VND 请传值 5000000

代付流程 (Withdraw)

创建代付订单

curl -X POST https://api.your-domain.com/gateway/api/v2/payouts \
  -H "Content-Type: application/json" \
  -d '{
    "platform_id": "your_platform_id",
    "service_id": "SVC0004",
    "payout_cl_id": "PAYOUT_12345",
    "amount": 5000000,
    "bank_name": "ACB",
    "number": "001234567890",
    "name": "NGUYEN VAN A",
    "currency": "vnd",
    "notify_url": "https://your-domain.com/callback",
    "request_time": 1595504997,
    "sign": "your_calculated_sign"
  }'

越南支援的服务

代收服务

服务 ID	类型	说明
SVC0015	银行卡	银行卡通道
SVC0016	网关直连	网关直连
SVC0017	QR 扫码	QR 扫码
SVC0018	MOMO	MOMO PAY
SVC0019	VIETTEL	VIETTEL PAY
SVC0047	ZALO	ZALO PAY
SVC0072	MOMO 原生	MOMO 原生

代付服务

服务 ID	类型	说明
SVC0004	银行卡	银行卡代付
SVC0018	MOMO	MOMO 代付（bank_name 填 "none"）
SVC0047	ZALO	ZALO 代付（bank_name 填 "none"）

以上为系统支援的服务项目。实际开通的服务以商务确认为准。