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
Encabezado | Descripción |
---|---|
Authorization requerida | El bearer token creado en Obtener token de autorización |
Content-Type requerido | application/json |
Parámetros de consulta
Parámetro | Tipo | Patrón | Descripción |
---|---|---|---|
card_number requerido | cadena | 16 dígitos* o uuid | El card_number o card_id que se solicitará. |
movements requeridos | booleano | verdadero o falso | Establece 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"
}
]
}
}