Mandatory parameters

Mandatory parameterDescription
login32 chars
pass32 chars
external_idMax. 100 chars
document_idSee document validations below.
document_typeDNI
RUC
CE - Carnet Extranjeria
PASS - Passport
See document validations.
beneficiary_nameMax. 50 chars
beneficiary_lastnameMax. 50 chars
countryPE
bank_accountSee bank account validations below.
account_typeC: for Checking accounts
S: for Savings accounts
M: for Maestra accounts
amountMax. 2 decimal numbers
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.

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",
"comments":"this is the 1st comment",
"currency":"PEN",
"extra_info":"{this_is_extra:2334}",
"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