# Supefina 秘鲁代付账户与银行编码说明

适用范围：`channelCode=supefina`、`PE / PEN`、`payTypeCode=bank`。

## 账户类型

商户只提交平台标准 `payeeType`：

- `BANK`：兼容账户类型。`payeeAccount` 必须是纯数字；13 位按活期账户处理并映射上游 `accountType=120`，14 位按储蓄账户处理并映射上游 `accountType=130`
- `SAVINGS`：储蓄账户
- `CHECKING`：支票/往来账户

`BANK` 账号不是 13/14 位纯数字时，平台会在请求上游前拒绝。商户也可以继续显式提交 `SAVINGS` 或 `CHECKING`；不得把 `120/130` 作为 `payeeType` 提交，也不得使用智利专属的 `VISTA`、`RUT_ACCOUNT`、`SALARY_ACCOUNT`。

## 证件类型

支持平台标准 `identityType`：`ID_CARD`、`TAX_ID`、`RESIDENCE_PERMIT`、`PASSPORT`、`MILITARY_ID`。不接受没有平台等价语义的上游 OTHER、出生证明或 `DRIVING_LICENSE` 替代值。

## 银行编码

`payeeBankCode` 必须是平台秘鲁银行标准编码，按字符串提交并保留前导零，例如 `002`。平台根据显式渠道映射生成 Supefina 银行编码和官方银行名称；商户不得提交渠道原始字段。

本次 Supefina 官方目录共 37 家，详见开放接口银行目录中的 `peru-platform-bank-code`。如目录未包含目标银行，请勿猜测或去掉前导零，应先申请维护平台标准和渠道映射。

## 必填字段

除公共代付字段外，还必须提供 `payeeName`、`payeeAccount`、`payeeBankCode`、`payeeMobile`、`payeeEmail`、`identityType`、`identityNo`。

回调中的 `merchantOrderNo` 是我方代付订单号，`platformOrderNo` 是 Supefina 上游订单号。异常冲正通知只进入人工资金复核，不会自动按普通失败回调改账。