Saltar al contenido principal

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

EncabezadoDescripción
Authorization 
requerida
El bearer token creado en
 Obtener token de autorización
Content-Type 
requerido
application/json

Parámetros de cuerpo

ParámetroTipoPatrónDescripción
origin_card 
requerida
cadena16 dígitos* o uuidEl card_number o card_id que se solicitará.
destination_card 
requerida
cadena16 dígitos*El card_number o card_id que se solicitará.
amount 
requerida
flotantedígitosMonto a transferir entre tarjetas
latitude 
requerida
flotanteFormato de dígitos "DD.ddddd" (5 decimales de precisión)Latitud desde donde se realiza la transferencia. Las latitudes sur están precedidas por un signo menos. Las latitudes van de -90 a 90
longitude 
requerida
flotanteFormato de dígitos "DDD.ddddd" (5 decimales de precisión)Longitud desde donde se realiza el traslado. 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:

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

Ejemplo de respuesta JSON:

{
"success": true,
"code": 0,
"message": "OK",
"data": {
"operation": {
"id": "a5030ec4-1f66-445d-b4d2-e3cf3a055fc1",
"authorization_code": 65498745,
"amount": 1000
},
"origin_card": {
"id": "11111111-daa7-1234-aaaa-123123123ecd",
"account_id": "22222222-daa7-1234-aaaa-123123123ecd",
"type": "PHYSICAL",
"card_number": "************1234",
"account_reference": 555555555,
"previous_balance": 3000,
"new_balance": 2000
},
"destination_card": {
"id": "33333333-daa7-1234-aaaa-123123123ecd",
"account_id": "44444444-daa7-1234-aaaa-123123123ecd",
"card_number": "************4321",
"previous_balance": 1000,
"new_balance": 2000
}
}
}