Saltar al contenido principal

Cambiar el estado de la tarjeta

Esta operación le permite cambiar el estado de la tarjeta. Puedes bloquear/desbloquear una tarjeta para aceptar o rechazar transacciones, reportar para un reemplazo o realizar bloqueos preventivos de la tarjeta.

Solicitud HTTP

PUT /cards/status

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 que se actualizará.
status
requerido
cadenaEstado de tarjetaEl estado de actualización de la tarjeta. Consulte los valores permitidos en
 el Catálogo de estado de la tarjeta
latitude 
requerida
flotanteFormato de dígitos "DD.ddddd" (5 decimales de precisión)Latitud desde donde se realiza la actualización de estado. 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 la actualización de estado. 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, 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",
"status": "TEMPORARY_INACTIVE",
"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": "TEMPORARY_INACTIVE"
},
"account": {
"id": "12312312-1234-1234-1234-123456123123",
"reference": "555555555"
}
}
}