Saltar al contenido principal

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

EncabezadoDescripción
Authorization 
requerida
El bearer token creado en
 Obtener token de autorización
Content-Type 
requerido
application/json

Parámetros de cuerpo

ParámetroTipoPatrónDescripción
card_number 
requerido
cadena16 dígitos* o uuidEl card_number o card_id que recibirá el desembolso
amount 
requerida
flotantedígitosEl monto a desembolsar
latitude 
requerida
flotanteFormato 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
flotanteFormato 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
}
}
}