Envío de remesas
Simulación
Permite simular cuánto dinero un destinatario recibirá.
Endpoint
GET /api/v3/transfers/simulate HTTP/1.1
Authorization: Bearer token
Content-Type: application/json
{
"source_amount_cents": 250,
"source_amount_currency": "CLP",
"country_id": 10,
"destination_amount_currency": "COP"
}
Parametros
Parametro | Detalles |
---|---|
source_amount_cents | Valor en "centavos" que se enviará |
source_amount_currency | Código de la moneda de origen |
country_id | ID del país donde se recibirá el dinero |
destination_amount_currency | Código de la moneda a recibir |
Ejemplo de respuestas
Respuesta 200
{
"source_currency": "CLP",
"destination_currency": "VES",
"rate": "0.0398742",
"source_amount_cents": 1000,
"destination_amount_cents": 3987,
"country": {
"id": 1,
"name": "Venezuela",
"code": "VE",
"is_asset": false
}
}
Explicación de parametros
Parametro | Detalles |
---|---|
source_currency | Moneda de origen |
destination_currency | Moneda de destino |
rate | Tipo de cambio hacia moneda de destino |
source_amount_cents | Dinero de origen en centavos |
destination_amount_cents | Dinero calculado hacia destinatario en centavos |
country | Datos de pais |
country.id | ID del país |
country.name | Nombre del país |
country.code | Codigo del país |
is_asset | Booleano identificador si el país es un activo (Crypto moneda u otro) |
Respuesta 404
{
"message": "exchange rate not available"
}
Crear envío
Endpoint
POST /api/v3/transfers HTTP/1.1
Authorization: Bearer token
Content-Type: application/json
{
"destination_account_id": 10,
"source_amount_cents": 1000,
"source_amount_currency": "CLP",
"destination_amount_currency": "COP"
}
Parametros
Parametro | Detalles |
---|---|
destination_account_id | ID de la cuenta de destino |
source_amount_cents | Dinero de origen en centavos |
source_amount_currency | Moneda de origen |
destination_amount_currency | Moneda de destino |
Ejemplo de respuestas
Respuesta 200
{
"id": 1675,
"source_amount_cents": 1000,
"source_amount_currency": "CLP",
"destination_amount_cents": 3987,
"destination_amount_currency": "VES",
"state": "pending",
"destination_account_id": 182
}
Parametros
Parametro | Detalles |
---|---|
id | Código identificador del envío |
source_amount_cents | Dinero de origen en centavos |
source_amount_currency | Moneda de origen |
destination_amount_cents | Dinero hacia el destinatario en centavos |
destination_amount_currency | Moneda de destino |
state | Estado del envío [pending, assigned, executed, rejected] |
destination_account_id | ID de la cuenta de destino |
Respuesta 404
{
"message": "destination_account not found"
}
Revisar envío
Endpoint
GET /api/v3/transfers/:id HTTP/1.1
Authorization: Bearer token
Parametros
Parametro | Detalles |
---|---|
id | ID/Código del envío. El parámetro debe estar en la url reemplazando ":id". Ejemplo: /api/v3/transfers/123123 |
Ejemplo de respuestas
Respuesta 200
{
"id": 1674,
"source_amount_cents": 2456,
"source_amount_currency": "CLP",
"destination_amount_cents": 9793,
"destination_amount_currency": "VES",
"state": "executed",
"destination_account_id": 182
}
Parametros
Parametro | Detalles |
---|---|
id | Código identificador del envío |
source_amount_cents | Dinero de origen en centavos |
source_amount_currency | Moneda de origen |
destination_amount_cents | Dinero hacia el destinatario en centavos |
destination_amount_currency | Moneda de destino |
state | Estado del envío [pending, assigned, executed, rejected] |
destination_account_id | ID de la cuenta de destino |
Respuesta 400
{
"message": "record_not_found"
}
Listar envios
Endpoint
GET /api/v3/transfers HTTP/1.1
Authorization: Bearer token
Ejemplo de respuestas
Respuesta 200
[
{
"id": 1671,
"source_amount_cents": 2456,
"source_amount_currency": "CLP",
"destination_amount_cents": 964228,
"destination_amount_currency": "COP",
"state": "assigned",
"destination_account_id": 118
},
{
"id": 1670,
"source_amount_cents": 2456,
"source_amount_currency": "CLP",
"destination_amount_cents": 964228,
"destination_amount_currency": "COP",
"state": "assigned",
"destination_account_id": 118
},
{
"id": 1669,
"source_amount_cents": 2456,
"source_amount_currency": "CLP",
"destination_amount_cents": 964228,
"destination_amount_currency": "COP",
"state": "assigned",
"destination_account_id": 118
},
]
Parametros
Parametro | Detalles |
---|---|
id | Código identificador del envío |
source_amount_cents | Dinero de origen en centavos |
source_amount_currency | Moneda de origen |
destination_amount_cents | Dinero hacia el destinatario en centavos |
destination_amount_currency | Moneda de destino |
state | Estado del envío [pending, assigned, executed, rejected] |
destination_account_id | ID de la cuenta de destino |