Realizar un pago a una tarjeta
Esta operación le permite realizar un pago a una tarjeta. El pago es similar a Desembolsar , 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_description requerida | cadena | 1-32 caracteres | La descripción del 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": "11111111-daa7-1234-aaaa-123123123ecd",
"amount": 1000.00,
"payment_description": "ABONO POR COMISIONES",
"latitude": 12.12345,
"longitude": -15.12345
}
Ejemplo de respuesta JSON:
{
"success": true,
"code": 0,
"message": "OK",
"data": {
"operation": {
"id": "4158d533-e95a-4c05-a341-ef7d369d3a09",
"authorization_code": "542010",
"amount": 1000.00,
"payment_description": "ABONO POR COMISIONES"
},
"card": {
"id": "11111111-daa7-1234-aaaa-123123123ecd",
"masked_card_number": "************1234",
"type": "PHYSICAL",
"status": "ACTIVE"
},
"account": {
"id": "22222222-daa7-1234-aaaa-123123123ecd",
"reference": 555555555
}
}
}