Realizar fondeo a una tarjeta
Esta operación le permite aplicar un desembolso a una tarjeta con el fin de permitirle aumentar su saldo disponible para realizar transacciones (compras, retiros o transferencias) y disminuye su saldo principal disponible.
Solicitud HTTP
POST /cards/disbursement
Parámetros del encabezado
Encabezado | Descripción |
---|---|
Authorization requerida | El bearer token creado en Obtener token de autorización |
Content-Type requerido | application/json |
Parámetros de cuerpo
Parámetro | Tipo | Patrón | Descripción |
---|---|---|---|
card_number requerido | cadena | 16 dígitos* o uuid | El card_number o card_id que recibirá el desembolso |
amount requerida | flotante | dígitos | El monto a desembolsar |
latitude requerida | flotante | Formato de dígitos "DD.ddddd" (precisión de 5 decimales) | Latitud desde donde se realiza el desembolso. Las latitudes sur están precedidas por un signo menos. Las latitudes van de -90 a 90 |
longitude requerida | flotante | Formato de dígitos "DDD.ddddd" (precisión de 5 decimales) | Longitud desde donde se realiza el desembolso. Las longitudes oeste están precedidas por un signo menos. Las longitudes varían de -180 a 180 |
Nota
*Si el card_number se envía con 16 dígitos, debe enviarse cifrado y codificado en Base 64. Consulte Codificación y cifrado de datos .
Ejemplo de solicitud JSON:
{
"card_number": "11111111-daa7-1234-aaaa-123123123ecd",
"amount": 10000.00,
"latitude": 12.12345,
"longitude": 15.12345
}
Ejemplo de respuesta JSON:
{
"success": true,
"code": 0,
"message": "OK",
"data": {
"operation": {
"id": "4158d533-e95a-4c05-a341-ef7d369d3a09",
"authorization_code": "542010",
"amount": 10000.00
},
"card": {
"id": "11111111-daa7-1234-aaaa-123123123ecd",
"masked_card_number": "************1234",
"type": "PHYSICAL",
"status": "ACTIVE"
},
"account": {
"id": "22222222-daa7-1234-aaaa-123123123ecd",
"reference": 555555555
}
}
}