> For the complete documentation index, see [llms.txt](https://docs.monnet.io/OoF1XuWTEpPjI0i2ERRO/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.monnet.io/OoF1XuWTEpPjI0i2ERRO/country-requirements/ecuador.md).
# Ecuador
The necessary information for Ecuador is presented below in order to carry out a correct payout.
## Mandatory parameters
| Field | Description |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| country | String (Required, length = 3)
ISO 3166-1-alpha-3. In the case of Ecuador: ECU
|
| amount | Integer (Required max-lenght = 10)
The amount of the transaction. The 2 last digits will be consider as decimal. Ex:
100000 equals "one thousand"
|
| currency | String (Required, length = 3)
The currency of the payroll. ISO-4217. In the case of ECU: USD
You can see the explication on /pages/goXlrdQZfDDMNgpat6RV
|
| oderId | String (Required max-lenght = 20 characters)
Merchant transaction code (Purchase Order)
|
| 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)
Type of Account of the beneficiary to pay. You must enter the numeric code as indicated
|
| beneficiary.document.number | String (Required)
Contains the beneficiary's document number.
|
| destination.bankAccount.bankCode | String (Required)
Codee of the receiving bank or financial institution.
|
| destination.bankAccount.accountType | Integer (Required)
Type of Account of the beneficiary to pay. You must enter the numeric code.
|
| destination.bankAccount.accountNumber | Integer (Required)
Beneficiary's account number.
|
| destination.bankAccount.expirationDate | Integer (Required only for Cash)
Expiration date to claim a Cash order. The format must be YYYY-MM-DD and in Local Time Zone (UTC-5). If the parameter is not sended or is "null", a default of 7 calendar days will be applied.
|
| 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
|
{% hint style="success" %}
New Feature
**Email Notification to the Beneficiary**
It is now possible to automatically send emails to the beneficiary with the outcome of the Payout (success or rejected).
**Requirements:**
* Request the activation of **"Email notifications to the user"** through your account manager.
* Include the `beneficiary.email` parameter in each transaction. If this field is missing, the email will not be sent.
{% endhint %}
{% hint style="info" %} **IMPORTANT**
For all Payouts
* The minimum amount allowed is 1.00 USD
**For Cash:**
* The minimum amount allowed is 1.00 USD and the maximum amount allowed is 900.00 USD.
* The value of destination.bankAccount.accountType must be always Cash (id = 4).
* The BankCode must always be Western Union (456), and the expiration date is automatically populated by the system with a standard payout expiration date (current date + 2 days); any expiration date provided by the user (in YYYY-MM-DD format and local time UTC-5) will be ignored.
* Expiration date cannot be the same day the order is sent, the day before, or exceed the following 7 calendar days. If the parameter is not sended or is "null", a default of 7 calendar days will be applied.
* The bankAccount.accountNumber it´s optional only for Cash.
* The beneficiary.email is mandatory. The instructions to claim the payout will be sent by this channel.
{% endhint %}
## Request Example
Payout - Bank Transfer
{
"country": "ECU",
"amount": 10000,
"currency": "USD",
"orderId": "R123456",
"description": "FreeTextFreeTextFreeTextFreeText",
"beneficiary": {
"name": "Sergio",
"lastName": "test",
"email": "test@test.com",
"document": {
"type": 1,
"number": "1234567891"
}
},
"destination": {
"bankAccount": {
"bankCode": "010",
"accountType": "1",
"accountNumber": "1234567891"
}
}
}
Payout - Cash
```
{
"country": "ECU",
"amount": 2000000,
"currency": "USD",
"orderId": "R123456",
"beneficiary": {
"name": "John",
"lastName": "Doe",
"document": {
"type": 1,
"number": "1333888555"
},
"customerId": "888888865",
"userName": "John Doe",
"email": "joh.doe@correo.com"
},
"destination": {
"bankAccount": {
"bankCode": "456",
"accountType": 4,
"accountNumber": "123456789",
"expirationDate": "2025-05-16"
}
}
}
```
{% hint style="danger" %} **Time Outs**
In the case of receiving a **Time Out** as a response from this API we recommend resending the payout again after 60 seconds using the same **orderId**.
This way we will check if the payout was processed and avoid double payments.
{% endhint %}
## Document Validations
| Parameter | ID Type | Length |
|---|
| 1 | Cedula | 10 digits |
| 2 | PAS | Min: 7 characters / Max: 13 characters
Only letters (A–Z) or digits (0–9). |
| 3 | RUC | 13 digits |
## Account Type
| Parameter | Type |
| --------- | --------------- |
| 1 | Current account |
| 2 | Savings account |
| 4 | Cash |
## Account Number Information
| Bank | Description |
| ---------------------- | ---------------------------------------------------------- |
| Banco Pichincha C.A. | Field “accountNumber” must contain 10 digits |
| Banco de Guayaquil S.A | Field “accountNumber” must contain max 10
digits
|
| Others Banks | From 7-20 digits |
## Bank List
| ID | Bank Name |
| --- | ------------------------------------ |
| 010 | Banco Pichincha C.A. |
| 017 | Banco de Guayaquil S.A |
| 024 | Banco City Bank |
| 025 | Banco Machala |
| 029 | Banco de Loja |
| 030 | Banco del Pacifico |
| 032 | Banco Internacional |
| 034 | Banco Amazonas |
| 035 | Banco del Austro |
| 036 | Produbanco/Promerica |
| 037 | Banco Bolivariano |
| 039 | Comercial de Manabi |
| 042 | Banco General Ruminahui S.A. |
| 043 | Banco del Litoral S.A. |
| 059 | Banco Solidario |
| 060 | Banco Procredit S.A. |
| 061 | Banco Capital |
| 065 | Banco Desarrollo de Los Pueblos S.A. |
| 066 | Banecuador B.P. |
| 201 | Banco Delbank S.A. |
| 213 | Cooperativa de Ahorro y Crédito JEP |
| 456 | Western Union (Cash) |