# PandaPay 代付账户类型与银行编码说明

## 越南 VN/VND

使用 `channelCode=pandapay`、`countryCode=VN`、`currency=VND`、`payeeType=BANK`。

- 必填 `payeeName`、`payeeAccount`、`payeeBankCode`、`payeeEmail`、`payeeMobile`，姓名/账号/邮箱/电话分别对应 `acc_name/acc_no/acc_email/acc_phone`，平台保留真实收款资料，不生成代付兜底。
- `payeeBankCode` 使用[越南平台标准银行码](./vietnam-bank-codes.html)。当前官方没有越南银行编码目录，按无编码国家契约固定 `acc_code=BANK`；这不是逐银行映射，也不表示所有银行均已核验支持。无需商户理解或提交该上游常量。
- `payeeBankName` 可选，对应 `bank_name`；不要求智利证件字段。不支持 BANK_CARD、钱包或其他国家的账户类型扩展。
- 金额单位为分，例如 100000 VND 提交 `applyAmount=10000000`。上游受理保持处理中，最终以签名回调或可靠查询结算；代付按提交金额核对冻结资金。接口代付需要先绑定服务器出口 IP。

来源：[PandaPay 官方代付协议](https://www.showdoc.com.cn/pandapay88/11558979663817313)，2026-10-11 复核。银行支持、商户产品开通、合同费率和限额需向渠道核验。

适用 `channelCode=pandapay`、`countryCode=CL`、`currency=CLP`、`payTypeCode=bank`。

- `payeeType`：支持平台标准 `BANK`、`BANK_CARD`、`CHECKING`、`PERSONAL_BANK`、`SAVINGS`、`VISTA`、`RUT_ACCOUNT`、`SALARY_ACCOUNT`，统一使用 BANK 产品提交上游。平台保留商户原始类型、账号及收款资料，由上游判断能否出款；兼容提交不表示这些账户类型必定支付成功。
- 必填：`payeeName`、`payeeAccount`、`payeeBankCode`、`payeeEmail`、`payeeMobile`、`identityType`、`identityNo`。
- `identityType`：`TAX_ID`（RUT）、`ID_CARD`（RUN）、`PASSPORT`（PAS）或 `RESIDENCE_PERMIT`（CE）。不要传上游数字代码。
- `payeeBankCode`：使用 [智利平台银行编码](./chile-bank-codes.html)，平台内部映射为 PandaPay `acc_code`。
- `merchantOrderNo` 是商户请求号；平台 BatchId 映射 PandaPay `order_no`；PandaPay `sys_no` 是上游订单号。

金额单位为分。代付需要渠道先绑定平台生产服务器出口 IP；该运营动作不由接口参数替代。

## 马来西亚 MY/MYR

使用 channelCode=pandapay、countryCode=MY、currency=MYR、payeeType=BANK、payTypeCode=bank。

- 必填：payeeName、payeeAccount、payeeBankCode、payeeEmail、payeeMobile。
- payeeName/payeeAccount/payeeEmail/payeeMobile 分别映射 acc_name/acc_no/acc_email/acc_phone。
- `payeeBankCode` 使用[马来西亚平台银行编码](./malaysia-bank-codes.html)中 PandaPay 已确认的 59 项映射；平台转换为 `acc_code`。平台标准码保持不变，上游编码按 2026-09-26 收到的更新名单调整。
- 更新示例：Maybank 对应 `acc_code=MAYBANK`，Public Bank 对应 `acc_code=PBB`，Hong Leong 对应 `acc_code=HLBB`，Alliance 对应 `acc_code=ABMB`，Affin 对应 `acc_code=ABB`，AmBank 对应 `acc_code=AMBB`。商户仍填写各行的平台标准码。
- 最新名单包含银行、钱包及其他机构条目，均按 PandaPay 的 BANK 代付产品目录核对；不据此增加新的 `payeeType`。`BOOST` 是 Boost eWallet，不能映射到 Boost Bank；`ARBank` 保留上游大小写。
- 原始名单共 61 项：59 项已确认、2 项待确认。`BNPB` 因现有 BNP Paribas 标准项重名待核对；`DUITNOWQR` 未找到等价平台标准项，不能套用 DuitNow 商业注册号、手机号等标准码。具体见银行页的待确认清单。
- 没有确认映射时，平台按商户原始 `payeeBankCode` 提交，由上游判断是否支持；透传不表示必定出款成功。目录新增项以已部署的银行映射及上游实际校验为准。
- 马来西亚不要求智利的 identityType/identityNo。
- 提交成功表示受理，最终状态通过查单或通知确认。金额为分。

来源：智利接口字段依据 PandaPay 官方 ShowDoc；马来西亚代付名单依据上游提供《panda-马来代付银行编码更新版.xlsx》的“代付银行”工作表，2026-09-26 读取。该文件另有“代收银行”工作表，本次不用于代付映射。

## 巴基斯坦 PK/PKR

使用 `channelCode=pandapay`、`countryCode=PK`、`currency=PKR`。支持三组平台标准类型：`payTypeCode=bank, payeeType=BANK`，`payTypeCode=easypaisa, payeeType=EASYPAISA`，`payTypeCode=jazzcash, payeeType=JAZZCASH`。

- 必填 `payeeName`、`payeeAccount`、`payeeEmail`、`payeeMobile`、`payeeBankCode`、`identityType=ID_CARD`、`identityNo`。`payeeMobile` 为 `03` 开头 11 位；证件号码填巴基斯坦身份证号。银行代付还需 `payeeBranchCode`，填 `PK` 开头的 IBAN。
- 银行 `payeeBankCode` 使用[巴基斯坦平台标准银行码](./pakistan-bank-codes.html)中 PandaPay 已确认的 32 家；钱包分别填写 `EASYPAISA`、`JAZZCASH`。完整上游映射见[目录](./payout-bank-catalog.html#pandapay-pk-pkr)。平台将标准码转换为 `acc_code`，将账户类型转换为 `otherpara2=BANK/WALLET`；商户不提交上游原码。找不到 PandaPay 映射时本地拒绝，不透传平台码。
- 平台 BatchId 对应上游 `order_no`，`sys_no` 是上游号。上游受理只表示处理中，最终按签名回调或可靠查单结算；代付按提交金额核对冻结资金。

编码依据：[PandaPay 巴基斯坦代付银行编码](https://www.showdoc.com.cn/pandapay88/11558979721034202)，2026-09-29 查阅。SQL 仅供手工部署，新建方法默认停用；实际商户产品、限额、费率、密钥及代付出口 IP 仍需按商户后台配置核验后启用。