# Ycoinpay 越南代付账户类型与银行编码说明

## 账户类型

| 字段 | 商户提交值 | Ycoinpay 映射 |
| --- | --- | --- |
| `payeeType` | `BANK`、`BANK_CARD` 或 `PERSONAL_BANK` | `accountType=account` |
| `payeeName` | 必填 | `accountName` |
| `payeeAccount` | 必填 | `accountNo` |
| `payeeBankCode` | 必填，优先使用平台越南标准银行码 | 命中映射时转换为 Ycoinpay 六位 `bankCode`；未命中映射时原值透传 |
| `countryCode` | `VN` | 越南 |
| `currency` | `VND` | 越南盾 |

Ycoinpay 代付固定使用 `payCode=ALL`。商户应优先提交平台标准银行码；平台命中渠道映射时转换为 Ycoinpay 六位编码，未命中映射时原值透传上游，不猜测转换。商户直接提交上游原始编码时，应自行确保该编码有效。

完整银行目录见 [越南银行编码目录](./vietnam-bank-codes.html)。当前 Ycoinpay 官方附件 40 条中，39 条已精确映射；`970454 / Ngân hàng TMCP Bản Việt` 待确认，未写入猜测映射。