Saltar al contenido principal

Activar una tarjeta

Esta operación le permite activar una tarjeta. Todas las tarjetas en stock se crean en un "estado no activo" (NEED_ACTIVATION) y debe activar cada tarjeta explícitamente.

Nota

Esta es una operación única por tarjeta. Se puede desembolsar o pagar una tarjeta NEED_ACTVATION, pero no se pueden hacer compras, retiros ni actualizaciones de PIN.

Solicitud HTTP

POST /cards/activate

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 del cuerpo

ParámetroTipoPatrónDescripción
card_number
requerido
cadena16 dígitos* o uuidEl card number o card_id de la tarjeta que se activará.
latitude 
requerida
flotanteFormato de dígitos "DD.ddddd" (precisión de 5 decimales)Latitud desde donde se realiza la activación. Las latitudes sur están precedidas por un signo menos. Las latitudes van desde -90 a 90
longitude 
requerida
flotanteFormato de dígitos "DDD.ddddd" (precisión decimal de 5)Longitud desde donde se realiza la activación. 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, se debe enviar cifrado y codificado en Base 64. Consulte Cifrado y codificación de datos .

Ejemplo de solicitud JSON:

{
"card_number": "11111111-daa7-1234-aaaa-123123123ecd",
"latitude": 12.12345,
"longitude": 15.12345
}

Ejemplo de respuesta JSON:

{
"success": true,
"code": 0,
"message": "OK",
"data": {
"card": {
"id": "11111111-daa7-1234-aaaa-123123123ecd",
"masked_card_number": "************1234",
"type": "PHYSICAL",
"status": "ACTIVE"
},
"account": {
"id": "12312312-1234-1234-1234-123456123123",
"reference": "555555555"
}
}
}