Realizar un pago a una tarjeta

Esta operación le permite realizar un pago a una tarjeta. El pago es similar a Fondear , pero le permite especificar una descripción para el pago. Esta operación aumenta el saldo disponible de su tarjeta y disminuye el saldo principal disponible.

Solicitud HTTP

POST /cards/payment

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 requerida	cadena	16 dígitos* o uuid	El card_number o card_id que recibirá el pago
amount  requerida	flotante	dígitos	El importe a recibir ha sido pagado
payment_code requerida	cadena	1-32 caracteres	Código de pago
latitude  requerida	flotante	Formato de dígitos "DD.ddddd" (5 decimales de precisión)	Latitud desde donde se realiza el pago. Las latitudes sur están precedidas por un signo menos. Las latitudes van de -90 a 90
longitude  requerida	flotante	Formato de dígitos "DDD.ddddd" (5 decimales de precisión)	Longitud desde donde se realiza el pago. 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": "0517a773-8b92-4255-98c3-2a802f7394ac",
    "amount": 1000.00,
    "payment_code": "D0010",
    "latitude": 12.12345,
    "longitude": -15.12345
}

Ejemplo de respuesta JSON:

{
    "success": true,
    "code": 0,
    "message": "OK",
    "data": {
        "operation": {
            "id": "cf7f10be-a967-4ad6-8ea0-b604070f6bfb",
            "authorization_code": "NBN26031919535019",
            "amount": 1000.00,
            "payment_description": "PAGO A TARJETA",
            "authorizer_date": "2026-03-19T13:53:50-06:00",
            "authorizer_time": "2026-03-19T13:53:50-06:00",
            "creation_timestamp": "2026-03-19T13:53:51.927-06:00"
        },
        "card": {
            "id": "0517a773-8b92-4255-98c3-2a802f7394ac",
            "masked_card_number": "************0123",
            "last_four": "0123",
            "type": "PHYSICAL",
            "status": "ACTIVE"
        },
        "account": {
            "id": "92286dcd-8639-4203-bfed-f78c4ab1bcf5",
            "reference": null
        },
        "cardholder": {
            "id": "133c9bd4-0bfc-46a9-a02a-2d40c4a42ac4",
            "curp": "MATO750627HQRGBS09",
            "rfc": "MATO750627XX1",
            "first_name": "TOBEY",
            "second_name": "",
            "third_name": "",
            "surname": "Vincent",
            "second_surname": "Maguire"
        },
        "product": {
            "id": "1c77e4ba-c536-4fa5-b3f8-a0f4427c333e",
            "code": "FMC0001"
        }
    }
}