Mandatory parameters

Mandatory parameterDescriptionFlow type
login32 charsALL
pass32 charsALL
external_idMax. 100 charsALL
document_idSee document validations below.ALL
document_typeDNI
RUC
CE - Carnet Extranjeria
PASS - Passport
See document validations.
ALL
beneficiary_nameMax. 50 charsALL
beneficiary_lastnameMax. 50 charsALL
countryPEALL
bank_accountSee bank account validations below.ALL
account_typeC: for Checking accounts
S: for Savings accounts
M: for Maestra accounts
ALL
currencyPEN or USD
amountMax. 2 decimal numbersALL
currency_to_payUSD
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.
Only for USD accounts
purposeEPREMT - Remittance (P2P)
Mandatory only for remittance (P2P)
P2P
remitter_full_nameMax. 200 chars
Mandatory only for remittance (P2P)
P2P
remitter_countryISO 3166-1 alpha-2 code
Mandatory only for remittance (P2P)
P2P
remitter_document_type'ID' for national identification number
'PASS' for passport
Mandatory only for remittance (P2P)
P2P
remitter_documentMax. 45 chars
Mandatory only for remittance (P2P)
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"
}

Document validations

ValidationNameLengthVerification digit
DocumentDNI8 Numeric or 9 AlphanumericLast digit
DocumentRUC11 NumericLast digit
DocumentCEMin 4 characters, Max 12 characters-
DocumentPASSMore than 4 characters-

Bank account validations

ValidationNameLengthTypeVerification digit
Bank accountCCI20NumericFirst 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 CodeBank NameSupport PEN currencySupport USD currency
001Banco Central de Reserva
002Banco de Crédito del Perú
003Interbank
007Citibank
009Scotiabank
010Banco del Pichincha
011BBVA Continental
018Banco de la Nación
023Banco de Comercio
035Banco Financiero
038Banco Interamericano de Finanzas (BIF)
043Crediscotia Financiera
049Mi Banco
053Banco GNB Perú S.A.
054Banco Falabella
055Banco Ripley
056Santander
800Caja Metropolitana de Lima
801Caja Municipal de Ahorro y Crédito Piura SAC
802Caja Municipal de Ahorro y Crédito Trujillo
803Caja Municipal de Ahorro y Crédito Arequipa
805Caja Municipal de Ahorro y Crédito Sullana
806Caja Municipal de Ahorro y Crédito Cuzco
808Caja Municipal de Ahorro y Crédito Huancayo
813Caja Municipal de Ahorro y Crédito Tacna