Actualizar estado de tokens por ID de tarjeta

PATCH/v1/tokens/cards/{external_card_id}

Actualizar estado de tokens por ID de tarjeta

Actualiza el estado de todos los tokens asociados a una tarjeta específica. Solo se actualizan los tokens que están en un estado válido para la transición solicitada. Los estados válidos son: ACTIVE (reactiva tokens suspendidos), BLOCKED (suspende tokens activados) y DISABLED (deshabilita tokens activados o suspendidos). Cuando el estado es BLOCKED o DISABLED, se requiere proporcionar un statusReason. Cuando el estado es ACTIVE, el campo statusReason se ignora si viene en el request.

Parámetros disponibles

Path Parameters

external_card_idStringrequired

Cuerpo de solicitud

application/json

statusenumrequired

statusReasonstring

Detalle de respuestas

401

No autorizado - Token inválido

403

Permiso denegado - Faltan roles necesarios

Ejemplo de solicitud

{
  "status": "BLOCKED",
  "statusReason": "Card blocked by user"
}

Ejemplo de código

curl -X PATCH "https://api.pomelo.la/v1/tokens/cards/example_value" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "status": "BLOCKED",
  "statusReason": "Card blocked by user"
}'

Ejemplo de respuesta (200)Respuesta exitosa con la lista de IDs de tokens actualizados

{
  "data": {
    "updateExternalTokenIds": [
      "DSHRMC1CO0303321afa9fb0a09b54051b21325c583jdu473",
      "DSHRMC1CO0303321afa9fb0a09b54051b21325c583jdu474"
    ]
  }
}

Eliminar token