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": 10000.0,
        "card": {
            "id": "1c77e4ba-c536-4fa5-b3f8-a0f4427c333e",
            "masked_card_number": "************0726",
            "last_four": "0726",
            "type": "PHYSICAL",
            "status": "ACTIVE"
        },
        "account": {
            "id": "92286dcd-8639-4203-bfed-f78c4ab1bcf5",
            "reference": null,
            "status": "ACTIVE"
        },
        "product": {
            "id": "133c9bd4-0bfc-46a9-a02a-2d40c4a42ac4",
            "name": "N09 PRODUCTO",
            "code": "DTC0001"
        },
        "movements": [
            {
                "fecha": "20260324",
                "hora": "14:12:29",
                "comercio": "ENVIO N09<->N09",
                "importe": -5.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "00408_40d23f4f141233",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "14:11:58",
                "comercio": "ENVIO N09<->N09",
                "importe": -1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "00407_0fc111be141201",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "13:44:52",
                "comercio": "ENVIO N09<->N09",
                "importe": -4.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "00404_1e89d43d134455",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "13:42:21",
                "comercio": "ENVIO N09<->N09",
                "importe": 3.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "NBN26032419422091",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "13:17:10",
                "comercio": "ENVIO N09<->N09",
                "importe": 1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "NBN26032419170902",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "13:14:57",
                "comercio": "ENVIO N09<->N09",
                "importe": 1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "NBN26032419145750",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "13:14:19",
                "comercio": "ENVIO N09<->N09",
                "importe": 1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "NBN26032419141877",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "12:39:24",
                "comercio": "ENVIO N09<->N09",
                "importe": 1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "SBN00399",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "11:13:13",
                "comercio": "ENVIO N09<->N09",
                "importe": -1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "00396_f1d0a7a2111317",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "10:48:05",
                "comercio": "ENVIO N09<->N09",
                "importe": 2.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "NBN26032416480448",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "10:33:04",
                "comercio": "ENVIO N09<->N09",
                "importe": 1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "SBN00394",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "10:21:09",
                "comercio": "ENVIO N09<->N09",
                "importe": -1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "00391_204cc62b102112",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "10:18:31",
                "comercio": "ENVIO N09<->N09",
                "importe": -1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "00390_b54f9eb8101835",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260324",
                "hora": "10:09:10",
                "comercio": "ENVIO N09<->N09",
                "importe": 1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "SBN00389",
                "estado_transaccion": "POSTED"
            },
            {
                "fecha": "20260323",
                "hora": "13:59:05",
                "comercio": "ENVIO N09<->N09",
                "importe": -1.0,
                "descripcion_importe": "ENVIO N09<->N09",
                "codigo_autorizacion": "00387_483f6b90135910",
                "estado_transaccion": "POSTED"
            }
        ]
    }
}