Obtener información de la tarjeta

Esta operación le permite consultar la información del usuario de la tarjeta.

Nota

** Si su clave API tiene una clave pública cargada, la operación devolverá el número de tarjeta cifrado. Consulte Agregar su clave pública**

Solicitud HTTP

GET /cards/info

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á.

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/info?card_number=11111111-daa7-1234-aaaa-123123123ecd

Ejemplo de respuesta JSON:

{
    "success": true,
    "code": 0,
    "message": "OK",
    "data": {
        "card": {
            "id": "11111111-daa7-1234-aaaa-123123123ecd",
            "masked_card_number": "************0710",
            "last_four": "0710",
            "type": "PHYSICAL",
            "status": "NEED_ACTIVATION",
            "product": {
                "id": "cf7f10be-a967-4ad6-8ea0-b604070f6bfb",
                "code": "TLC0001",
                "name": "SUPER PRODUCTO N09",
                "description": "N09 Card for SUPER PRODUCTO"
            },
            "observations": "Asignacion 120326",
            "assignation_timestamp": "2026-03-12T17:15:34.581-06:00",
            "assigned_by": "92286dcd-8639-4203-bfed-f78c4ab1bcf5",
            "activation_timestamp": null,
            "activated_by": null,
            "replaced_timestamp": null,
            "replaced_by": null,
            "cancellation_timestamp": null,
            "cancelled_by": null,
            "external_id": null,
            "activity": {
                "last_approved_operation": null,
                "last_denied_operation": null,
                "last_block_status": null
            },
            "sensitive_data": {
                "cvv": "aEjEqUxqN3hWPbU9TeD2zmh/mIkc55bbTSlxTXTxAYSipClkFKI8PjhEQqA/n2roJna/eED/h+JBI+t7sqRpzFqW5ADdrAaQCK4prIktlmUwAxxckWHzDpw3f2s/LAg4wxRAd1MYf9g4yyFyCdp+Knyfk3GzP0lowiSiCo/uf/jGY147lRxkHD+/M59ILaAvwxrib75pXoVvCEuqagKc7Pr0UkUFnmqmUFnsrmDkxqhe4dgV3w3/IEysOZTNF0/sJ6DFrWZ/uZ0CW/pG5NlCROgIh/X9rL1/BZRmeB64u7riWE8z9z/OLIu8VoLCVc42j9nBI+Uh9siONGcLJAmnyw==",
                "expiration_year": "PWFTr5aPMaNYNdEyxjABHTnMy1yi9sflYl/Z+07WpjY0p1kgtLb22GBWWfVJhWDqCq/3Mn5xMqkjX+Je+7mXasTacGGo/T5tArkOadkZMSjaEQQPyaEkVYWD3PZkPM4w9gaKY96wP2uWjrJ90fJQ39bpBBxbGzx/h38RLg7iCUai5uuWyD51FbdUk3H5WzyrpkPlHe0Npvlnns76rxXiFvxmmJm9UXvIu7vE6Yb8vx421YW5Fr2kb3/G5+dQOHyvUMAcf/NfVJfB0QIOnRJOaK7GxKszVO1c3JaFMMBBj2yTmjF4o1OH6W62C9MDclLFchEI968Fqdr/2zQsg1Qcvg==",
                "expiration_month": "d0vFq6ow1pJsNOy5k1ZFIYkEN9TtH38lanD1yRFAN71eAJbpJ7MWLUxGOHWAMu8tXwP+oeCGypx0Q2QzIJniMOXzRlt3KYBw0jen0537FZTv9wJwwrhZwnCZvxEFdKJ5GJnozyAPqYaJobqMJB1XkHrMOCBIA+Cy12svElnnmplvcwy9FeUwPReYkO8Gzh0As8HCFqnLYDMzpvodzC1hfjPvvV2jcwSj+BJYsSMgfmyYYWIRqddI3A3sp+AAHKeUlaswbJG0cFv7dDVip/hphJFiL100isOFDUvwopyWZfUZhIDVgI77MKoI8zJOUBPCpOVapr48Ysd7+v7+wXsH/g==",
                "encrypted_card": "Rrm7A47YnmRUbP4QMgLHuwNRWTxJxaV65mXkU6Tbw5x9pNKP6XxWiGvrdZE0t7oD0OqxfV1jFU2L0tT2BuVLRjX2Dv8pku0QDZr2kOZjBx2mlaCgeGh3QNknYjsiZdUoUdI6PmTD1yBdsMo5qlZtEteD+2/GQowo0WrCVt0vM1yaznVEjQqg6A4yHgh9WfVZumJ5sBYAq8f6DKVk7t44A/Ym8ITxudk+sgUVeD1SuaadDm44mZMyC1EZ5ftODLYaFutPzadkZY9F+DTB5SI+B7UQ6lXa4NU0Ffpg2HzLR7z2OceqyZlBlpJo8bqqSAcF+rDxFkV18ZCT6p+F3OugwA=="
            }
        },
        "account": {
            "id": "133c9bd4-0bfc-46a9-a02a-2d40c4a42ac4",
            "reference": "1215",
            "observations": "Asignacion 120326",
            "clabe": null,
            "status": "ACTIVE",
            "document": {
                "type": "CURP",
                "number": "TEST_STATUS_1"
            },
            "assignation_timestamp": "2026-03-12T00:00:00.000-06:00",
            "assigned_by": "0517a773-8b92-4255-98c3-2a802f7394ac",
            "activation_timestamp": "2026-03-12T17:15:37.059-06:00",
            "activated_by": "0517a773-8b92-4255-98c3-2a802f7394ac",
            "product": {
                "id": "cf7f10be-a967-4ad6-8ea0-b604070f6bfb",
                "code": "TLC0001",
                "name": "SUPER PRODUCTO N09",
                "description": "N09 Card for SUPER PRODUCTO"
            }
        },
        "cardholder": {
            "id": "089904b2-d53b-4020-9072-08fcbeb2d0c7",
            "first_name": "Tobias",
            "surname": "Vincent",
            "phone": "2345665328",
            "mobile_phone": "2345665389",
            "email": "[email protected]",
            "street": "CERRADA 2 DE ABRIL",
            "postal_code": "90120",
            "township": "DE DOMINGO ARENAS",
            "country": "484",
            "observations": "CARDHOLDER STATUS"
        }
    }
}