Realizar fondeo a una tarjeta

Esta operación le permite aplicar un desembolso a una tarjeta con el fin de permitirle aumentar su saldo disponible para realizar transacciones (compras, retiros o transferencias) y disminuye su saldo principal disponible.

Solicitud HTTP

POST /cards/disbursement

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 desembolso
amount  requerida	flotante	dígitos	El monto a desembolsar
latitude  requerida	flotante	Formato de dígitos "DD.ddddd" (precisión de 5 decimales)	Latitud desde donde se realiza el desembolso. 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" (precisión de 5 decimales)	Longitud desde donde se realiza el desembolso. Las longitudes oeste están precedidas por un signo menos. Las longitudes varían 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": 10000.00,
    "latitude": 12.12345,
    "longitude": 15.12345
}

Ejemplo de respuesta JSON:

{
    "success": true,
    "code": 0,
    "message": "OK",
    "data": {
        "operation": {
            "id": "1c77e4ba-c536-4fa5-b3f8-a0f4427c333e",
            "authorization_code": "SBN00380",
            "amount": 10000.00,
            "payment_description": "EMPRESA",
            "authorizer_date": "2026-03-19T12:57:31-06:00",
            "authorizer_time": "2026-03-19T12:57:31-06:00",
            "creation_timestamp": "2026-03-19T12:57:32.539-06:00"
        },
        "card": {
            "id": "11111111-daa7-1234-aaaa-123123123ecd",
            "masked_card_number": "************0959",
            "last_four": "0959",
            "type": "PHYSICAL",
            "status": "ACTIVE"
        },
        "account": {
            "id": "92286dcd-8639-4203-bfed-f78c4ab1bcf5",
            "reference": null
        },
        "cardholder": {
            "id": "133c9bd4-0bfc-46a9-a02a-2d40c4a42ac4",
            "curp": "MAXT750627HQRGBS09",
            "rfc": "MATO750627XX1",
            "first_name": "Tobias",
            "second_name": "",
            "third_name": "",
            "surname": "Vincent",
            "second_surname": "Maguire"
        },
        "product": {
            "id": "cf7f10be-a967-4ad6-8ea0-b604070f6bfb",
            "code": "FMC0001"
        }
    }
}