Realizar una transferencia entre tarjetas

Esta operación permite realizar una transferencia C2C (Tarjeta a Tarjeta) entre las tarjetas del ecosistema BIN.

Solicitud HTTP

POST /cards/transfer

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
origin_card  requerida	cadena	16 dígitos* o uuid	El card_number o card_id que se solicitará.
destination_card  requerida	cadena	16 dígitos*	El card_number o card_id que se solicitará.
amount  requerida	flotante	dígitos	Monto a transferir entre tarjetas

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:

{
    "origin_card": "11111111-daa7-1234-aaaa-123123123ecd",
    "destination_card": "v7ut6AztPIH_SJK9gRETQQnFmqFPS-qcexyuRly0Hr9_jaG5YAnE_7CNNl_nbLYBi6YJvpnoZFSQdVgPaSEPPbPEhyR_y3zTup6ZTQto0FXE1ArtLPmntQ6-RKg",
    "amount": 1000
}

Ejemplo de respuesta JSON:

{
    "success": true,
    "code": 0,
    "message": "OK",
    "data": {
        "operation": {
            "id": "111d1d11-222c-4ca2-9a7f-9ea949d787ac",
            "authorization_code": "00409_8e53bf98811111",
            "amount": 1.0,
            "authorizer_date": "2026-03-24T16:47:46-06:00",
            "authorizer_time": "2026-03-24T16:47:46-06:00",
            "creation_timestamp": "2026-03-24T16:47:48.218-06:00"
        },
        "origin_card": {
            "id": "111d1d11-222c-4ca2-9a7f-9ea949d787ac",
            "account_id": "111d1d11-222c-4ca2-9a7f-9ea949d787ac",
            "type": "PHYSICAL",
            "masked_card_number": "************0959",
            "last_four": "0959",
            "account_reference": null,
            "previous_balance": 3779.0,
            "new_balance": 3778.0
        },
        "destination_card": {
            "id": "111d1d11-222c-4ca2-9a7f-9ea949d787ac",
            "account_id": "111d1d11-222c-4ca2-9a7f-9ea949d787ac",
            "masked_card_number": "************0975",
            "last_four": "0975",
            "previous_balance": 131.0,
            "new_balance": 132.0
        }
    }
}