Saltar al contenido principal

Consultar el saldo de la tarjeta

Estas operaciones le permiten consultar el saldo de una tarjeta y la información de transacciones recientes.

Solicitud HTTP

GET /cards/balance

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 consulta

ParámetroTipoPatrónDescripción
card_number
requerido
cadena16 dígitos* o uuidEl card_number o card_id que se solicitará.
movements 
requeridos
booleanoverdadero o falsoEstablece si quieres los últimos movimientos.
Nota

*Si el card_number se envía con 16 dígitos, debe enviarse cifrado y codificado en Base 64 con URL y alfabeto seguro para nombres de archivo. Consulte Codificación y cifrado de datos .

Ejemplo de solicitud JSON:

GET /cards/balance?card_number=11111111-daa7-1234-aaaa-123123123ecd&movements=true

Ejemplo de respuesta JSON:

{
"success": true,
"code": 0,
"message": "OK",
"data": {
"available": 500,
"card": {
"id": "11111111-daa7-1234-aaaa-123123123ecd",
"masked_card_number": "************1234",
"type": "PHYSICAL",
"status": "ACTIVE"
},
"account": {
"id": "12312312-1234-1234-1234-123456123123",
"reference": "555555555"
},
"movements": [ {
"fecha": "20201214",
"hora": "195550",
"comercio": "FINPULSO SAPI",
"importe": "350.11",
"descripcion_importe": null,
"codigo_autorizacion": "504884"
}
]
}
}