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 |
latitude requerida | flotante | Formato 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 | flotante | Formato 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
}
}
}