Aplicar una compra a una tarjeta

Esta operación le permite aplicar un cargo a una tarjeta especificando una descripción del comerciante para el cargo. Esta operación disminuye el saldo disponible de su tarjeta y aumenta el saldo de cobro de su cuenta.

Solicitud HTTP

POST /cards/purchase

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 cuerpo

Parámetro	Tipo	Patrón	Descripción
card_number requerido	cadena	16 dígitos* o uuid	El card_number o card_id que recibirá el cargo.
amount requerida	flotante	dígitos	El importe a cobrar
charge_code requerida	cadena	5 caracteres	El nombre o descripción del cargo
latitude requerida	flotante	Formato de dígitos "DD.ddddd" (5 decimales de precisión)	Latitud desde donde se aplica la compra. Las latitudes sur están precedidas por un signo menos. Las latitudes oscilan entre -90 y 90
longitude  requerida	flotante	Formato de dígitos "DDD.ddddd" (5 decimales de precisión)	Longitud desde donde se aplica la compra. Las longitudes Oeste van precedidas de un signo menos. Las longitudes van 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": 1000.55,
    "charge_code": "C0019",
    "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": "35c8679a121352",
            "amount": 1000.55,
            "merchant": null,
            "merchant_description": null,
            "charge_description": "CARGO POR COMISIONES",
            "authorizer_date": "2026-02-03T12:13:47-06:00",
            "authorizer_time": "2026-02-03T12:13:47-06:00",
            "creation_timestamp": "2026-02-03T12:13:48.348-06:00"
        },
        "card": {
            "id": "11111111-daa7-1234-aaaa-123123123ecd",
            "masked_card_number": "************1234",
            "last_four": "0975",
            "type": "PHYSICAL",
            "status": "ACTIVE"  
        },
        "account": {
            "id": "22222222-daa7-1234-aaaa-123123123ecd",
            "reference": 555555555
        }
    }
}