秘鲁

国家域名及编码（秘鲁）

国家/地区	国家编码	域名	货币代码	货币名称
秘鲁	pe	global-pe-openapi.toppayment.com	PEN	秘鲁索尔

域名：推荐使用统一域名 openapi.toppayment.com（路径不变）；原国别域名仍可继续使用。

实际域名与商户环境以运营配置为准；路径模板与其他国家一致：/sandbox/{countryCode}/...（沙箱）、/{countryCode}/...（生产）。

代收支付方式编码

调用秘鲁代收接口（/pay/prePay，域名/国家码见上表）时，在 method 传递下列编码（与渠道 PeruMethodEnum 一致）。开放接口字段说明与示例见 代收订单-秘鲁。

支付方式编码	说明
DOCUMENTS	证件/银行账户类收银

若网关扩展更多 method，以接口返回与运营下发清单为准。

秘鲁证件类型（documentType）

与开放接口 documentType 取值一致（忽略大小写）。

编码	说明
DNI	秘鲁国民身份证（Documento Nacional de Identidad）
CE	外国人身份证（Carné de extranjería）
PAS	护照
RUC	税号（Registro Único de Contribuyentes），企业场景常用

秘鲁代付账户类型（accountType）

与开放接口代付侧 accountType（或等价字段）取值一致（忽略大小写），与 PeruAccountTypeEnum 对齐。

编码	说明
CORRIENTE	活期账户
AHORROS	储蓄账户
WALLET	钱包（如 Yape / Plin 等）

代付银行及对应编码（bankCode / bankName）

以下编码用于秘鲁代付订单创建与查询（/disbursement/cash、/disbursement/query）的 bankCode 与展示名 bankName；类型为银行或钱包。代付请求体字段及示例见 代付订单-秘鲁。

bankCode	bankName	类型
BCP	Banco de Credito	银行
Scotiabank	Scotiabank	银行
Interbank	Interbank	银行
BBVA	Banco Continental	银行
Yape	Yape	钱包
Plin	Plin	钱包
Sullana	Caja Sullana	银行
Piura	Caja Piura	银行
Huancayo	Caja Huancayo	银行
Cusco	Caja Cusco	银行
Maynas	Caja Maynas	银行
Metropolitana	Caja Metropolitana	银行
MunicipalIca	Caja Municipal Ica	银行
Tacna	Caja Tacna	银行
Trujillo	Caja Trujillo	银行
Arequipa	Caja Arequipa	银行
BanBif	Banco Interamericano de Finanzas	银行
GNB	Banco GNB	银行
Comercio	Banco de Comercio	银行
CrediScotia	Banco CrediScotia	银行
Nation	Banco de la Nación	银行
Falabella	Banco Falabella	银行
Pichincha	Banco Pichincha	银行
Azteca	Banco Azteca	银行
Ripley	Banco Ripley	银行
MiBanco	Banco MiBanco	银行
Cencosud	Banco Cencosud	银行
Santander	Banco Santander	银行
Financiero	Banco Financiero	银行
Citibank	Citibank	银行
ICBC	ICBC PERU BANK	银行

代收与代付订单 status 字段取值说明见 交易状态码。