# 开放接口附录 - 代收 `payTypeCode` 总目录

**版本日期**：2026-04-20  
**适用接口**：`POST /api/PayRequest/UnifiedPay`

---

## 1. 文档目的

本文档是**代收**方向的总入口：帮助商户在已了解统一协议（签名、公共字段、响应验签）的前提下，按 **`payTypeCode`（平台产品编码）** 找到对应渠道的**产品级附录**，核对 `payMethodCode`、`country`、`instrument` 与 `Ext` 等条件必填规则。

统一协议与主数据快照见站点 **`api-docs.html`** 中「统一响应与主数据编码」章节；路由四字段语义见 **[开放接口附录-路由字段语义说明.md](./开放接口附录-路由字段语义说明.md)**。

---

## 2. 如何选产品

1. 确认业务为**代收**，并已知平台分配的 **`channelCode`（渠道编码）** 或渠道键。  
2. 在 **`pay-method-type-master.json`** 或 **`api-docs.html`** 主数据表中筛选 `business_type = ACQUIRE` 对应的 `payTypeCode`。  
3. 打开下表中对应渠道的**代收附录**，按国家 / `payTypeCode` 查看必填与最小示例。  
4. 若主数据中存在但下表未列出的渠道，仍以**商户后台开通**与 **`api-docs.html` 动态表**为准，并联系运营获取最新附录链接。

---

## 3. 按渠道的代收附录索引

| 渠道（渠道键；开放接口 `channelCode` 与同目录参考 JSON 一致） | 附录文件 |
| --- | --- |
| NovaVexis | [开放接口附录-NovaVexis代收pay_type_code接入说明.md](./开放接口附录-NovaVexis代收pay_type_code接入说明.md) |
| CowPay | [开放接口附录-CowPay代收pay_type_code接入说明.md](./开放接口附录-CowPay代收pay_type_code接入说明.md) |
| Eqpay | [开放接口附录-Eqpay代收pay_type_code接入说明.md](./开放接口附录-Eqpay代收pay_type_code接入说明.md) |
| Fzpay | [开放接口附录-Fzpay代收pay_type_code接入说明.md](./开放接口附录-Fzpay代收pay_type_code接入说明.md) |
| Ynuopay | [开放接口附录-Ynuopay代收pay_type_code接入说明.md](./开放接口附录-Ynuopay代收pay_type_code接入说明.md) |
| Cofrapay | [开放接口附录-Cofrapay代收pay_type_code接入说明.md](./开放接口附录-Cofrapay代收pay_type_code接入说明.md) |
| Otomatis | [开放接口附录-Otomatis代收pay_type_code接入说明.md](./开放接口附录-Otomatis代收pay_type_code接入说明.md) |
| FenDpay | [开放接口附录-FenDpay代收pay_type_code接入说明.md](./开放接口附录-FenDpay代收pay_type_code接入说明.md) |

**联调与回调**：多渠道路由最小请求见 **[开放接口附录-多渠道联调最小请求示例汇总.md](./开放接口附录-多渠道联调最小请求示例汇总.md)**；回调处理见 **[开放接口附录-回调验签与成功响应最小实现示例.md](./开放接口附录-回调验签与成功响应最小实现示例.md)**。

---

## 4. 首批建议覆盖 SKU（与整改方案 §15.3 / §15.4 / §15.5 对齐）

下列 `payTypeCode` 为文档优先覆盖范围；实际开通以环境主数据为准。

**NovaVexis（代收）**：`novavexis_bd_acquire_bkash`、`novavexis_bd_acquire_nagad`、`novavexis_bd_acquire_rocket`、`novavexis_br_acquire_pix_qrcode`、`novavexis_ph_acquire_phqr`、`novavexis_ph_acquire_gcash`、`novavexis_pk_acquire_pkr_easypaisa`、`novavexis_pk_acquire_pkr_jazzcash`、`novavexis_pk_acquire_pkrqr`、`novavexis_vn_acquire_vnqr`（若环境另有 NovaVexis 代收 SKU，一并纳入渠道附录维护）。

**CowPay（代收，规范 SKU）**：孟加拉 `cowpay_bd_acquire_bkash`、`cowpay_bd_acquire_nagad`、`cowpay_bd_acquire_bkash_native`；印度 `cowpay_in_acquire_bkash`、`cowpay_in_acquire_nagad`、`cowpay_in_acquire_bkash_native`；巴基斯坦 `cowpay_pk_acquire_jazzcash`、`cowpay_pk_acquire_easypaisa`；美国 `cowpay_us_acquire_cashapp`、`cowpay_us_acquire_chime`、`cowpay_us_acquire_bankcard`、`cowpay_us_acquire_paypal`、`cowpay_us_acquire_applepay`、`cowpay_us_acquire_googlepay`、`cowpay_us_acquire_ach`。

**Ynuopay（代收，高频）**：`ynuopay_us_acquire`、`ynuopay_in_acquire`、`ynuopay_in_acquire_wakeup`、`ynuopay_bd_acquire_bkash`、`ynuopay_bd_acquire_nagad`、`ynuopay_bd_acquire_rocket`、`ynuopay_bd_acquire_uaw`、`ynuopay_ph_acquire_gcash_native`、`ynuopay_ph_acquire_gcashwap` 等（完整列表以 **[Ynuopay 代收附录](./开放接口附录-Ynuopay代收pay_type_code接入说明.md)** 与主数据为准）。

**Cofrapay（代收）**：菲律宾 `gcash`、`maya`、`gotyme`。这些是平台按 PH/PHP 合并后的标准支付类型，上游真实 `type=gcash/maya/gotyme` 由 `pay_method.upstream_type_code` 映射。

**Otomatis（代收）**：印尼 IDR `otomatis_id_acquire_qris`、`otomatis_id_acquire_va`。QRIS 返回二维码原文时收银台直显二维码；VA 返回纯数字虚拟账号时收银台展示付款账号指引。

**FenDpay（代收）**：印度 INR `fendpay_in_acquire_h5`，唤醒/H5 收银产品；上游路径 `/pay/payment`，金额按 INR 主币单位提交。

---

## 5. 附录与主数据变更记录

各附录文件的修订历史见 **[开放接口附录-CHANGELOG.md](./开放接口附录-CHANGELOG.md)**。