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 Currencies
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

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.

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 be always Western Union (456)

• 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.

Request Example

Payout - Bank Transfer

{
	"country": "ECU",
	"amount": 10000,
	"currency": "USD",
	"orderId": "R123456",
	"description": "FreeTextFreeTextFreeTextFreeText",
	"beneficiary": {
		"name": "Sergio",
		"lastName": "test",
		"email": "[email protected]",
		"document": {
			"type": 1,
			"number": "1234567891"
		}
	},
	"destination": {
		"bankAccount": {
			"bankCode": "010",
			"accountType": "1",
			"accountNumber": "1234567891"
		}
	}
}

Payout - Cash

{
    "country": "ECU",
    "amount": 2000000,
    "currency": "USD",
    "orderId": "BJB_{{randomUUID}}",
    "beneficiary": {
        "name": "John {{randomFirstName}}",
        "lastName": "Doe {{randomLastName}}",
        "document": {
            "type": 1,
            "number": "1333888555"
        },
        "customerId": "{{randomUUID}}",
        "userName": "John Doe",
        "email": "[email protected]"
    },
    "destination": {
        "bankAccount": {
            "bankCode": "456",
            "accountType": 4,
            "accountNumber": "123456789",
            "expirationDate": "2025-05-16"
        }
    }
}

Time Outs

In the case of receiving a Time Out as a response from this API we recommend resending the payout again after 30 seconds using the same orderId.

This way we will check if the payout was processed and avoid double payments.

Document Validations

Parameter	ID Type	Length
1	Cedula	10 digits
2	PAS	13 digits (It is obligatory to end in 001)
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)