Payout to Peru (Bank Transfer)

To send a payout to Peru, set the payout_method to BANK_TRANSFER. The required_PE object must include both the bank_code, account_type, account_number, identifier, identifier_type, email, full_name of the recipient.

  POST https://api-sandbox.epag.io/payoutTransaction

identifier_type

string, required

This field specifies the type of identification document.

Allowed values:

• CE: Foreign resident card in Colombia and Peru. For Peru, max length is 12 characters.
• DNI: Identity Document in Peru. Must be 8 characters in length.
• PAS: Passport in Peru.
• RUC: Tax ID number in Peru. Must be 11 characters in length.

identifier

string, required

This field contains the identification document number.

• For DNI in Peru: It must be 8 characters in length.
• For RUC in Peru: It must be 11 characters in length.
• For CE in Peru: The max length is 12 characters.
• For PAS in Peru: The max length is 12 characters.

bank_code

string, required

This field contains the bank code of the recipient's institution in Peru.

Bank codes are specific to each country, so retrieve the valid values from the Financial Institutions endpoint with country=PE and send only a code returned by that call. Never reuse a code from another country's catalog. The Banks table below lists them for reference.

account_type

string, required

This field defines the bank account type.

Allowed values:

• CC: Current Account in Peru.
• CA: Savings Account in Peru.
• CM: "Cuenta maestra" in Peru.

account_number

string, required

This field contains the bank account number.

• If the bank_code is 002 (BCP) and the account_type is CC, it must be 13 digits in length.
• If the bank_code is 002 (BCP) and the account_type is CA, it must be 14 digits in length.
• If the bank_code is different than 002, you must send the CCI (Código de cuenta interbancaria). This must contain exactly 20 digits and be presented without spaces, hyphens, or special characters.

Example Request

{
    "payoutTransactions": [
        {
            "original_amount": 200.00,
            "original_currency": "PEN",
            "payment_currency": "PEN",
            "payment_country": "PE",
            "payout_method": "BANK_TRANSFER",
            "contract_id": "MY_PAYOUT_CONTRACT_ID",
            "reference_id": "MY_REFERENCE_ID",
            "notification_url": "https://my.notification.url/callback",
            "required_PE": {
                "bank_code": "003",
                "account_type": "CA",
                "account_number": "00316301312597216937",
                "identifier": "70015101",
                "identifier_type": "DNI",
                "email": "[email protected]",
                "full_name": "Alice Sonnentag"
            }
        }
    ]
}

Example Response

{
    "payoutTransactionResponses": [
        {
            "tx_id": "PAYOUT_REFERENCE_ID",
            "reference_id": "MY_REFERENCE_ID",
            "amount": 200,
            "original_amount": 200,
            "original_asset": "PEN",
            "customer_fees": 0,
            "customer_amount": 200,
            "merchant_fees": 0,
            "merchant_amount": 200,
            "asset": "PEN",
            "banking_data": "003:CA:00316301312597216937",
            "status": "CREATED"
        }
    ],
    "refresh_token": "MY_ACCESS_TOKEN"
}

Banks

The table below is a reference snapshot. For the list that is currently valid, query the Financial Institutions endpoint with country=PE.

Code	Name
001	BANCO CENTRAL DE RESERVA
002	BANCO DE CREDITO DEL PERU | BCP
003	INTERBANK
007	CITIBANK
009	SCOTIABANK
011	BBVA
018	BANCO DE LA NACION
023	BANCO DE COMERCIO
035	BANCO FINANCIERO
038	BIF | BANCO INTERAMERICANO DE FINANZAS
043	CREDISCOTIA FINANCIERA
049	MIBANCO
053	BANCO GNB PERU
054	FALABELLA
055	RIPLEY
056	SANTANDER
057	DEUTSCHE BANK
058	ALFIN BANCO
059	BANCO CENCOSUD
060	ICBC
062	BANK OF CHINA
063	BCI
073	FINANCIERA CREDINKA
091	COMPARTAMOS FINANCIERA
093	FINANCIERA QAPAQ
094	TARJETA OH
096	FINANCIERA EFECTIVA
099	FINANCIERA CONFIANZA
256	EEDE TARJETAS PERUANAS
776	PREXPE
800	CAJA METROPOLITANA
801	CMAC PIURA
802	CMAC TRUJILLO
803	CMAC AREQUIPA
805	CMAC SULLANA
806	CMAC CUSCO
808	CMAC HUANCAYO
809	CMAC ICA
811	CMAC MAYNAS
813	CMAC TACNA
849	CAJA LOS ANDES
901	YAPE
902	PLIN
904	BIM
910	ABACCO
921	LIGO
922	DALE