# Countries Peru > Create a Payout for Peru using our API and Dashboard export const bankTransfer = PAYOUT_PAYMENT_METHODS.find( (method) => method.id === "bank-transfer", ); # đŸ‡”đŸ‡Ș Peru Learn everything you need to know about making payouts in Peru. ## Payment Methods Checkout our SLAs for each payment method: ## Instructions To create a payout using EBANX Direct API, follow the steps below. ### Define request parameters Provide the required parameters listed below to create a payout. | Field | Description | | -------------------- | -------------------------------------------------------------------------------------------------------------------------- | | `integration_key` | Your EBANX integration key. | | `external_reference` | The unique payout ID provided by you. | | `country` | The two-letter country code for the customer country. In this case, we'll show the method to pe (Peru) | | `amount` | The amount in the specified currency (currency_code). | | `currency_code` | Three-letter code of the payout currency. In this case, we'll use PEN (Peruvian Sol) | | `payee` | A JSON object containing the details of the payee of your request. | **Document Types Allowed** These document types are used to identify payees or shareholders. | Document type | Description | | ------------- | ------------------------------------------------------------------- | | RUC | Registro Único de Contribuyentes (Tax ID for companies), 11 digits. | | DNI | Documento Nacional de Identidad (National ID), 8 digits. | | PASS | Passport number. | | CE | Carnet de ExtranjerĂ­a (Foreigner ID). | ### Send payout request to EBANX To create a new Payout, you will use the [**/ws/payout/create**](/api-reference?api=payout&page=post--ws-payout-create) endpoint. Choose the transaction type for your payout request: B2C (Individual) } > The following example demonstrates a payout request to an individual payee: ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.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", "payee_message": "You have received a transfer from Ebanx!", "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. ```json { "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, "request_currency": "PEN", "request_exchange_rate": 1, "debit_amount": 500, "debit_fee": 5, "debit_amount_total": 505, "debit_currency": "PEN", "local_tax_amount": "0.00", "local_amount_total": "500.00", "local_currency": "PEN", "local_exchange_rate": "1.0000" } } ``` B2B (Organization) } > To create a payout for an organization entity (company), you need to use the **RUC** document type. ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.com/ws/payout/create' \ --header 'Content-Type: application/json' \ --data '{ "integration_key": "your_test_integration_key", "external_reference": "PAYOUT_EBANX_PE_B2B", "country": "pe", "amount": 5000, "currency_code": "PEN", "payee_message": "You have received a transfer from Ebanx!", "payee": { "name": "Empresa Peruana SAC", "email": "contacto@empresaperuana.com", "phone": "+5114567890", "document": "20123456789", "document_type": "RUC", "bank_info": { "bank_name": "002 Banco de Credito del Peru", "bank_account": "19112345678901", "account_type": "C" }, "address": { "zipcode": "15001", "state": "Lima", "city": "Lima", "street_address": "Av. Javier Prado Este 4600", "street_complement": "Oficina 501" } } }' ``` **With Shareholder Information:** For organizations, you can include shareholder data. The following fields are required in the **shareholder** object: - `name` - `document` - `document_type` ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.com/ws/payout/create' \ --header 'Content-Type: application/json' \ --data '{ "integration_key": "your_test_integration_key", "external_reference": "PAYOUT_EBANX_PE_B2B_SH", "country": "pe", "amount": 10000, "currency_code": "PEN", "payee_message": "You have received a transfer from Ebanx!", "payee": { "name": "Empresa Peruana SAC", "email": "contacto@empresaperuana.com", "phone": "+5114567890", "document": "20123456789", "document_type": "RUC", "bank_info": { "bank_name": "002 Banco de Credito del Peru", "bank_account": "19112345678901", "account_type": "C" }, "address": { "zipcode": "15001", "state": "Lima", "city": "Lima", "street_address": "Av. Javier Prado Este 4600", "street_complement": "Oficina 501" }, "shareholder": [ { "name": "Carlos Perez Garcia", "document": "12345678", "document_type": "DNI", "email": "carlos.perez@mail.com", "ownership_percent": 60 }, { "name": "Maria Lopez Sanchez", "document": "87654321", "document_type": "DNI", "email": "maria.lopez@mail.com", "ownership_percent": 40 } ] } }' ``` ### 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**](/api-reference?api=payout&page=post--ws-payout-commit) endpoint to start the payment process. Here's an example of a commit operation using the payout we've just created: ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.com/ws/payout/commit' \ --header 'Content-Type: application/json' \ --data '{ "integration_key": "{{integration_key}}", "uid": "{{payout_uid}}" }' ``` Once the new payout is committed, a JSON Object with type "success" will be returned. ```json { "type": "success", "message": "Payout has already been committed" } ``` ### 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 Code | Institution Name | | :-------- | :---------------------------------------- | | **002** | Banco de CrĂ©dito del PerĂș (BCP) | | **003** | Interbank | | **007** | Citibank del PerĂș | | **009** | Scotiabank PerĂș | | **011** | BBVA PerĂș | | **018** | Banco de la NaciĂłn | | **022** | Banco Santander PerĂș | | **023** | Banco de Comercio | | **035** | Banco Financiero | | **038** | Banco Interamericano de Finanzas (BanBif) | | **043** | Banco GNB PerĂș | | **049** | Mibanco | | **053** | Banco Falabella PerĂș | | **054** | Banco Ripley | | **056** | Banco Azteca del PerĂș | | **058** | Banco Pichincha | ## Possible Errors Click here and check out our **Payout Error Code page** to learn more about the possible errors. ## Still need help? If you still have questions, you can explore the following options: - **Merchant support:** Contact our support team at [sales.engineering@ebanx.com](mailto:sales.engineering@ebanx.com) for assistance. - **Not a partner yet?** Complete the [Merchant Signup Form](https://business.ebanx.com/en/request-contact), and our commercial team will reach out to you.