Peru
Country domains & codes (Peru)
| Country/Region | Country Code | Domain | Currency Code | Currency Name |
|---|---|---|---|---|
| Peru | pe | global-pe-openapi.toppayment.com | PEN | Peruvian Sol |
Domain: Prefer the unified host
openapi.toppayment.com(path unchanged); legacy country domains remain available.
Sandbox/production hostnames are subject to your account setup; URL patterns follow the same convention as other regions: /sandbox/{countryCode}/... (sandbox) and /{countryCode}/... (production).
Pay-In method codes
Use these values in the method field for Peru Pay-In (/pay/prePay, domain/country code as above). Aligned with PeruMethodEnum. Open-API field descriptions and examples: Pay-In Orders — Peru.
| Method code | Description |
|---|---|
| DOCUMENTS | Bank/document-style checkout |
If additional method values are enabled by the gateway, follow the live response and the list provided by operations.
Peru ID document types (documentType)
Must match the open API documentType field (case-insensitive).
| Code | Description |
|---|---|
| DNI | National ID (Documento Nacional de Identidad) |
| CE | Foreign resident ID (Carné de extranjería) |
| PAS | Passport |
| RUC | Tax ID (Registro Único de Contribuyentes), common for businesses |
Peru pay-out account types (accountType)
Must match the pay-out side accountType (or equivalent) (case-insensitive), aligned with PeruAccountTypeEnum.
| Code | Description |
|---|---|
| CORRIENTE | Checking account |
| AHORROS | Savings account |
| WALLET | Wallet (e.g. Yape / Plin) |
Pay-Out bank / wallet codes (bankCode / bankName)
Use these for Peru Pay-Out create/query (/disbursement/cash, /disbursement/query). Type indicates bank vs wallet. Pay-Out request fields and examples: Pay-Out Orders — Peru.
| bankCode | bankName | Type |
|---|---|---|
| BCP | Banco de Credito | Bank |
| Scotiabank | Scotiabank | Bank |
| Interbank | Interbank | Bank |
| BBVA | Banco Continental | Bank |
| Yape | Yape | Wallet |
| Plin | Plin | Wallet |
| Sullana | Caja Sullana | Bank |
| Piura | Caja Piura | Bank |
| Huancayo | Caja Huancayo | Bank |
| Cusco | Caja Cusco | Bank |
| Maynas | Caja Maynas | Bank |
| Metropolitana | Caja Metropolitana | Bank |
| MunicipalIca | Caja Municipal Ica | Bank |
| Tacna | Caja Tacna | Bank |
| Trujillo | Caja Trujillo | Bank |
| Arequipa | Caja Arequipa | Bank |
| BanBif | Banco Interamericano de Finanzas | Bank |
| GNB | Banco GNB | Bank |
| Comercio | Banco de Comercio | Bank |
| CrediScotia | Banco CrediScotia | Bank |
| Nation | Banco de la Nación | Bank |
| Falabella | Banco Falabella | Bank |
| Pichincha | Banco Pichincha | Bank |
| Azteca | Banco Azteca | Bank |
| Ripley | Banco Ripley | Bank |
| MiBanco | Banco MiBanco | Bank |
| Cencosud | Banco Cencosud | Bank |
| Santander | Banco Santander | Bank |
| Financiero | Banco Financiero | Bank |
| Citibank | Citibank | Bank |
| ICBC | ICBC PERU BANK | Bank |
For Pay-In and Pay-Out status values, see Transaction Status Codes.