Create a Payout
About this guide
This guide quickly demonstrates how to create a payout in EBANX. We will walk you through the basic steps to achieve this goal using your already existing Direct API integration.
How it works
To create a payout through EBANX Direct API, please follow the steps below.
Make sure you have all the mandatory fields in your request
There are a few key parameters you need to provide to create a payout. Check the table below for more details.
Field Description integration_keyYour unique and secret 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 ar (Argentina) amountThe amount in the specified currency (currency_code). currency_codeThree-letter code of the payout currency. In this case, we'll use ARS (Argentina) payeeA JSON object containing the details of the payee of your request. Payee Details
Note that you can either provide all the information of the payee directly on you payout creation request or create the payee record in advance, using the /ws/payee/create endpoint, and simply provide the payee's document number in the payout request.
Document Types Allowed:
These types of documents are used by the payees or shareholders.
Document type Description DNI National Identity Document, with 8 digits. CUIL Unique Labor Identification Code, with 11 digits. CUIT Single Tax identification. Send your payout request to EBANX
To create a new Payout, you will use the /ws/payout/create endpoint.
There are two ways to create a payout for Argentina.
1 - MercadoPago
The following example is a payout create request for a MercadoPago account. You need to send the target key filled up with mercadopago and the key target_account with the MercadoPago account email.
curl -X POST 'https://sandbox.ebanxpay.com/ws/payout/create' \-d 'integration_key=your_test_integration_key' \-d 'external_reference=PAYOUT_EBANX_04' \-d 'country=ar' \-d 'amount=100' \-d 'currency_code=ARS' \-d 'target=mercadopago' \-d 'target_account=chew@bac.ca' \-d 'payee[document]=85351346' \-d 'payee[document_type]=DNI' \-d 'payee[name]=Han Solo' \-d 'payee[email]=chew@bac.ca' \-d 'payee[address][zipcode]=B1675' \-d 'payee[address][state]=AR-B' \-d 'payee[address][city]=Buenos Aires' \-d 'payee[address][street_address]=Fake Street' \-d 'payee[address][street_complement]=123'2 - Bank Account
The target key is bank_account by default so, for bank account payouts, it can be ommitted.
For bank account payouts, you need to send the bank_info tag with only the bank_details key filled up with the CBU/CVU number.
The bank_details key is mandatory. The API expects a 22 characters long that holds the CBU/CVU number.
The account_type attribute is used to inform what type of account will receive the desposit. It is needed to be sent using or C for Checkings or S for Savings. It is mandatory.curl -X POST 'https://sandbox.ebanxpay.com/ws/payout/create' \-d 'integration_key=your_test_integration_key' \-d 'external_reference=PAYOUT_EBANX_04' \-d 'country=ar' \-d 'amount=100' \-d 'currency_code=USD' \-d 'payee[name]=Han Solo' \-d 'payee[email]=chew@bac.ca' \-d 'payee[phone]=+554112345678' \-d 'payee[document]=34585474' \-d 'payee[document_type]=DNI' \-d 'payee[bank_info][bank_details]=3365196911100062632985' \-d 'payee[bank_info][account_type]=C' \-d 'payee[address][zipcode]=B1675' \-d 'payee[address][state]=AR-B' \-d 'payee[address][city]=Buenos Aires' \-d 'payee[address][street_address]=Fake Street' \-d 'payee[address][street_complement]=123'For organizations, some fields are mandatory in shareholder set:
- name
- document
- document_type
And 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": "a1352f5341c3c8c1e40ea9c06715f05778ff35ee","external_reference": "PAYOUT_EBANX_04","status": "OP","request_date": "2020-09-18 13:26:53","status_date": null,"paid_date": null,"cancel_date": null,"payee": {"name": "Han Solo","email": "chew@bac.ca","phone": "554112345678","document": "85351346893","document_type": "DNI","bank_info": {"bank_name": "104 Caixa Econ\u00f4mica","bank_branch": "3708","bank_account": "8251777-6","account_type": "C","bank_details": "001"}},"request_amount": "10.00","request_currency": "USD","request_exchange_rate": "1.0000","debit_amount": "10.00","debit_fee": "0.15","debit_amount_total": "10.15","debit_currency": "USD","local_tax_amount": "0.12","local_amount_total": "32.88","local_currency": "USD","local_exchange_rate": "3.2997"}}Send a 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.ebanxpay.com/ws/payout/commit' \-d 'integration_key=your_test_integration_key' \-d 'uid=0e495f7a4409c032d54376084b10b9c771e9b39f0'Once the new Payout is commited, a JSON Object with type "success" will be returned.
{"type": "success","message": "Payout has already been committed"}
Creating a Payout using Dashboard
You can also create a payout through your Dashboard in the Overview section of the Payout tab. Click on Create Payout, fill in the payee information, payout amount and click Create. Additionally, you can create a Mass Payout for up to 600 payouts.
Getting help
We hope this article was enlightening, but in case we’ve failed to take out your doubts you have the following options to keep on seeking for answers:
- If you’re not our partner yet and would like to know more about our prices and conditions please fill our this form and our commercial team will get in touch with you.
- In case you’re already our partner please get in touch with our support team at integration@ebanx.com.