Skip to main content

🇵🇪 Peru

Learn everything you need to know about making payouts in Peru.

Payment Methods

  • Instant Payout Instant
  • Bank Transfer

Available Operations

  • Cross Border

Payee Types

  • B2B
  • B2C

Payment Methods​

Checkout our SLAs for each payment method:

Payment MethodSLAB2BB2C
Instant PayoutInstant Payout< 2 minutescheck_circle_outlinecheck_circle_outline
Bank TransferBank TransferUp to 3 dayscheck_circle_outlinecheck_circle_outline

Instructions​

To create a payout using EBANX Direct API, follow the steps below.

  1. Define request parameters
    ​

    Provide the required parameters listed below to create a payout.

    FieldDescription
    integration_keyYour EBANX integration key.
    external_referenceThe unique payout ID provided by you.
    countryThe two-letter country code for the customer country. In this case, we'll show the method to pe (Peru)
    amountThe amount in the specified currency (currency_code).
    currency_codeThree-letter code of the payout currency. In this case, we'll use PEN (Peruvian Sol)
    payeeA JSON object containing the details of the payee of your request.
    transaction_typeMust be filled with B2B (Legal entity to Legal entity) or B2C (Legal entity to Individual). Required for Peru.
    Transaction Type Required

    For Peru, the transaction_type field is mandatory. You must specify either B2B for business-to-business payouts or B2C for business-to-consumer payouts.


    Document Types Allowed

    These document types are used to identify payees or shareholders.

    Document typeDescription
    RUCRegistro Único de Contribuyentes (Tax ID for companies), 11 digits.
    DNIDocumento Nacional de Identidad (National ID), 8 digits.
    PASSPassport number.
    CECarnet de Extranjería (Foreigner ID).

  2. Send payout request to EBANX
    ​

    To create a new Payout, you will use the /ws/payout/create endpoint.

    Choose the transaction type for your payout request:

    The following example demonstrates a payout request to an individual payee:

    curl -X POST 'https://sandbox.ebanx.com/ws/payout/create' \
    --header 'Content-Type: application/json' \
    --data '{
      "integration_key": "your_test_integration_key",
      "external_reference": "PAYOUT_EBANX_PE_01",
      "country": "pe",
      "amount": 500,
      "currency_code": "PEN",
      "transaction_type": "B2C",
      "payee": {
        "name": "Carlos Perez Garcia",
        "email": "carlos.perez@email.com",
        "phone": "+51912345678",
        "document": "12345678",
        "document_type": "DNI",
        "bank_info": {
          "bank_name": "002 Banco de Credito del Peru",
          "bank_account": "19112345678901",
          "account_type": "S"
        },
        "address": {
          "zipcode": "15001",
          "state": "Lima",
          "city": "Lima",
          "street_address": "Av. Javier Prado Este 4600",
          "street_complement": "Piso 5"
        }
      }
    }'

    A successful creation will return a JSON Object with type "success" and a payout object with all the details of the newly created payout.

    {
      "type": "success",
      "payout": {
        "uid": "e5796f5341c3c8c1e40ea9c06715f05778ff35ee",
        "external_reference": "PAYOUT_EBANX_PE_01",
        "status": "OP",
        "request_date": "2024-01-15 10:30:00",
        "status_date": null,
        "paid_date": null,
        "cancel_date": null,
        "payee": {
          "name": "Carlos Perez Garcia",
          "email": "carlos.perez@email.com",
          "phone": "51912345678",
          "document": "12345678",
          "document_type": "DNI",
          "birthdate": null,
          "bank_info": {
            "bank_name": "002 Banco de Credito del Peru",
            "bank_branch": null,
            "bank_account": "19112345678901",
            "account_type": "S",
            "bank_details": null
          }
        },
        "request_amount": "500.00",
        "request_currency": "PEN",
        "request_exchange_rate": "1.0000",
        "debit_amount": "500.00",
        "debit_fee": "5.00",
        "debit_amount_total": "505.00",
        "debit_currency": "PEN",
        "local_tax_amount": "0.00",
        "local_amount_total": "500.00",
        "local_currency": "PEN",
        "local_exchange_rate": "1.0000"
      }
    }

  3. Send commit request to EBANX
    ​

    Once the new payout record is created it'll be committed automatically after 6 hours. Or you can use the /ws/payout/commit endpoint to start the payment process.

    Here's an example of a commit operation using the payout we've just created:

    curl -X POST 'https://sandbox.ebanx.com/ws/payout/commit' \
    --header 'Content-Type: application/json' \
    --data '{
      "integration_key": "your_test_integration_key",
      "uid": "e5796f5341c3c8c1e40ea9c06715f05778ff35ee"
    }'

    Once the new payout is commited, a JSON Object with type "success" will be returned.

    {
      "type": "success",
      "message": "Payout has already been committed"
    }

  4. Congratulations!
    ​

    You have successfully Created a Payout in Peru.

Creating a Payout using the Dashboard​

You can also create a payout through our Dashboard in the Overview section of the Payout tab. Click on Create Payout, fill in the payee information, payout amount and click on Create. Additionally, you can use the Mass Payout feature to send payouts in batches.

Available Banks​

Bank CodeInstitution Name
002Banco de Crédito del Perú (BCP)
003Interbank
007Citibank del Perú
009Scotiabank Perú
011BBVA Perú
018Banco de la Nación
022Banco Santander Perú
023Banco de Comercio
035Banco Financiero
038Banco Interamericano de Finanzas (BanBif)
043Banco GNB Perú
049Mibanco
053Banco Falabella Perú
054Banco Ripley
056Banco Azteca del Perú
058Banco Pichincha

Possible Errors​

Click here and check out our Payout Error Code page to learn more about the possible errors.

Still need help?

Help Image

We hope this article was helpful. If you still have questions, you can explore the following options: