Peru

The necessary information for Peru is presented below in order to carry out a correct payout.

Mandatory parameters

Field
Description

country

String (Required- Lenght: 3 characters)

ISO 3166-1-alpha-3. In the case of Peru: PER

amount

Integer (Required max-lenght = 10 digits)

The amount of the transaction. The 2 last digits will be consider as decimal. Ex: 100000 equals "one thousand"

currency

String (Required- Lenght: 3 digits)

orderId

String (Required- Max Lenght: 20 characters)

Merchant transaction code. This ID must be unique per transaction.

description

String (Optional - Max Lenght: 50 characters)

For customer use

beneficiary.name

String (Required)

Name of the Beneficiary

beneficiary.lastName

String (Required)

Last name of the Beneficiary

beneficiary.email

String (Optional- Max Lenght: 50 characters)

Beneficiary's email

beneficiary.document.type

Integer (Required)

Contains the beneficiary's document type. You must enter the parameter as indicated in "Document Validations"

beneficiary.document.number

String (Required)

Contains the beneficiary's document number. You can see how many digits must it have in "Document Validations"

destination.bankAccount.bankCode

String (Optional - Lenght: 3 characters)

Code of the receiving bank or financial institution as indicated in "Bank List". It is mandatory if account type is "Cellphone Numer (4)".

destination.bankAccount.accountType

Integer (Required) Type of Account of the beneficiary to pay. You must enter the numeric code.

destination.bankAccount.accountNumber

Integer (Optional) Beneficiary's account number. In the case of account type is "Cellphone Number"(4), the merchant have to send the phone number. Ex: 948474375

destination.bankAccount.cci

Integer (Required - Lenght: 20 digits)

"Codigo de Cuenta Interbancaria (CCI)". Interbanking number account.

subMerchantInfo.code

String (Required only for PSP) Submerchant Identifier

subMerchantInfo.name

String (Required only for PSP) Submerchant Name

subMerchantInfo.url

String (Required only for PSP) Submerchant URL

IMPORTANT

  • For Account Type "Cellphone Number" the only currency available is "PEN"

  • For Account Type "Cellphone Number" the maximum amount allowed is 500 PEN. For others Account Types the maximum amount allowed is 30,000 PEN.

Request Example

CCI payout

{
	"country": "PER",
	"amount": 100000,
	"currency": "PEN",
	"orderId": "R123456",
	"description": "FreeTextFreeTextFreeTextFreeText",
	"beneficiary": {
		"name": "Sergio",
		"lastName": "test",
		"email": "test@test.com",
		"document": {
			"type": 1,
			"number": "12345678"
		}
	},
	"destination": {
		"bankAccount": {
			"bankCode": "002",
			"accountType": "1",
			"cci": "00243000584290204477"
		}
	}
}

Bank directly payout

{
	"country": "PER",
	"amount": 100000,
	"currency": "PEN",
	"orderId": "R123456",
	"description": "FreeTextFreeTextFreeTextFreeText",
	"beneficiary": {
		"name": "Sergio",
		"lastName": "test",
		"email": "test@test.com",
		"document": {
			"type": 1,
			"number": "12345678"
		}
	},
	"destination": {
		"bankAccount": {
			"bankCode": "001",
			"accountType": "1",
			"accountNumber": "001106660100012345"
		}
	}
}

Time Outs

In the case of receiving a Time Out as a response from this API we recommend resending the payout again after 30 seconds using the same orderId.

This way we will check if the payout was processed and avoid double payments.

Document Validations

Parameter
ID Type
Lenght

1

DNI

8 digits

2

PAS

7 - 12 digits

3

CE

8 - 12 digits

4

RUC

11 digits

Account Type

Parameter
Type

1

Current Account

2

Savings Account

4

Cellphone Number - Available from Feb 2025

Account Number Information

Bank
Description

Banco BBVA (001)

Field “accountNumber” must contain 18 or 20 digits EX: 001106660100012345 (18 digits) EX: 00110666010001234512 (20 digits)

Banco de Credito (002)

Field “accountNumber” must contain: - 13 digits for Current or Master Account - 14 digits for Savings Account

Interbank (003)

Field “accountNumber” must contain 13 digits

Scotiabank (004)

Field “accountNumber” must contain 10 digits 0037651234 (10 digits: 3 agency + 7 account)

For any other bank or financial institution

A 20-digit CCI interbank account code must be entered. Example: 00219400254640654321 (20 digits)

Wallets (Yape,Plin, Bim, CCE directory)

Field “accountNumber” must contain 9 digits and start with "9".

Bank List

ID
Bank Name

001

Banco BBVA

002

Banco de Credito

003

Interbank

004

Scotiabank

005

Banco de Comercio

006

Banco Interamericano de Finanzas (BanBif)

007

Banco Pichincha

008

Citibank

011

Banco GNB

014

Banco Santander

016

Banco Cencosud

017

ICBC PERU BANK

018

Banco de la Nación

019

Caja Arequipa

020

Caja Cusco

021

Caja Huancayo

022

Caja Maynas

023

Caja Metropolitana

024

Caja Municipal Ica

026

Caja Sullana

027

Caja Tacna

028

Caja Trujillo

029 (Available from Feb 2025)

Credinka (Available from Feb 2025)

030

Banco Falabella

031

Caja Los Andes

032

Mibanco

033

BIM

034

Caja Piura

035

Ripley

036

Financiera Efectiva

037

Yape

038

Compartamos Financiera

039

Banco Alfin

040

Plin

041

Cooperativa Abaco

042

Luqea

043

Tarjetas Peruanas Prepago

044

Financiera Confianza

045

Prex

046

Tarjeta Oh

Last updated