Market specifications

Do you want to know more information about Peru's market? Go to the Peru’s economy and eCommerce market article.

Country reference

`country` code	`currency` code	`amount` decimals	`document_type` name	`document_id` format
`PE`	`PEN`	2	DNI or RUC	Between 8 to 9 digits for DNI and 11 digits for RUC.

Document validations

Validation	Name	Length	Verification digit
Document	DNI	8 numeric characters or 9 alphanumeric characters.	Last digit
Document	RUC	11 numeric	Last digit
Document	CE	Between 4 and 12 alphanumeric characters.	-
Document	PASS	Between 4 and 12 alphanumeric characters.	-

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B	USD accounts	P2P
`login`	Yes	Yes	Yes	Yes
`pass`	Yes	Yes	Yes	Yes
`external_id`	Yes	Yes	Yes	Yes
`document_id`	Yes	Yes	Yes	Yes
`document_type`	Yes	Yes	Yes	Yes
`beneficiary_name`	Yes	Yes	Yes	Yes
`beneficiary_lastname`	Yes	Yes	Yes	Yes
`country`	Yes	Yes	Yes	Yes
`bank_account`	Yes	Yes	Yes	Yes
`account_type`	Yes	Yes	Yes	Yes
`currency`	Yes	Yes	Yes	Yes
`amount`	Yes	Yes	Yes	Yes
`currency_to_pay`	-	-	Yes	-
`purpose`	-	-	-	Yes
`remitter_full_name`	-	-	-	Yes
`remitter_country`	-	-	-	Yes
`remitter_document_type`	-	-	-	Yes
`remitter_document`	-	-	-	Yes

Payment methods

Peru supports payouts via Bank transfers. This method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Bank transfers

Bank transfers in Peru require detailed account information, including document ID, document type, bank account (CCI), account type, and currency. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the document validations, bank account validations and bank codes sections for format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`login`	API authentication credentials. Maximum 32 characters.
`pass`	API authentication credentials. Maximum 32 characters.
`external_id`	Unique transaction identifier. Maximum 100 characters.
`document_id`	Document ID of the beneficiary. See document validations below.
`document_type`	Document type: `DNI`, `RUC`, `CE` (Carnet Extranjeria), `PASS` (Passport). See document validations.
`beneficiary_name`	First name of the beneficiary. Maximum 50 characters.
`beneficiary_lastname`	Last name of the beneficiary. Maximum 50 characters.
`country`	Country code. For Peru, use `PE`.
`bank_account`	Bank account number. See bank account validations below.
`account_type`	Account type: `C` for Checking accounts, `S` for Savings accounts, `M` for Maestra accounts.
`currency`	Payout currency. For Peru, use `PEN` or `USD`.
`amount`	Payout amount. Use up to 2 decimal numbers.
`currency_to_pay`	Currency to be paid out. `USD`. Mandatory only if the payout needs to be paid in USD. In case this parameter is missing, the payout will be paid in local currency.
`purpose`	Reason for the payout. `EPREMT` - Remittance (P2P). Mandatory only for remittance (P2P).
`remitter_full_name`	Full name of the sender. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter_country`	ISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (P2P).
`remitter_document_type`	Type of identification document: `ID` for national identification number, `PASS` for passport. Mandatory only for remittance (P2P).
`remitter_document`	Document number of the sender. Maximum 45 characters. Mandatory only for remittance (P2P).

Example request

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "1234567812345678b",
  "document_id": "12345678",
  "document_type": "DNI",
  "beneficiary_name": "JUANA",
  "beneficiary_lastname": "PEREZ",
  "country": "PE",
  "bank_code": "002",
  "bank_account": "00219300247595201411",
  "account_type": "S",
  "amount": "245.40",
  "currency": "PEN",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Peru.

Bank account validations

Validation	Name	Length	Type	Verification digit
Bank account	CCI	20	Numeric	First 3 digits will be the bank code and the last 2 apply verification algorithm

Bank codes

Check below the different values that bank_code parameter can take in Peru.

Bank Name	Bank Code	Support PEN currency	Support USD currency
Banco Central de Reserva	001
Banco de Comercio	023
Banco de Crédito del Perú	002
Banco de la Nación	018
Banco del Pichincha	010
Banco Falabella	054
Banco Financiero	035
Banco GNB Perú S.A.	053
Banco Interamericano de Finanzas (BIF)	038
Banco Ripley	055
BBVA Continental	011
Caja Metropolitana de Lima	800
Caja Municipal de Ahorro y Crédito Arequipa	803
Caja Municipal de Ahorro y Crédito Cuzco	806
Caja Municipal de Ahorro y Crédito Huancayo	808
Caja Municipal de Ahorro y Crédito Piura SAC	801
Caja Municipal de Ahorro y Crédito Tacna	813
Citibank	007
Crediscotia Financiera	043
Interbank	003
Mi Banco	049
Santander	056
Scotiabank	009