PATCH
/cards/v1/{id}Actualizar Tarjeta
El endpoint /cards/v1/{id} te permite actualizar el estado de una tarjeta, su grupo de afinidad y el PIN.
Consideraciones
Deberás especificar una razón del siguiente listado para poder actualizar el estado de una tarjeta:
| Nuevo estado | Razón válida |
|---|---|
| BLOCKED / DISABLED | CLIENT_INTERNAL_REASON |
| BLOCKED / DISABLED | USER_INTERNAL_REASON |
| DISABLED | LOST |
| DISABLED | STOLEN |
| DISABLED | BROKEN |
| DISABLED | UPGRADE |
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
Cuerpo de solicitud
application/jsonaffinity_group_idstring
statusenum
status_reasonenum
pinstring
parent_idstring
Detalle de respuestas
401
No autorizado
403
Acceso denegado
Ejemplo de solicitud
{
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"status": "ACTIVE",
"status_reason": "CLIENT_INTERNAL_REASON",
"pin": "1234",
"parent_id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5"
}Ejemplo de código
curl -X PATCH "https://api.pomelo.la/cards/v1/{id}" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"status": "ACTIVE",
"status_reason": "CLIENT_INTERNAL_REASON",
"pin": "1234",
"parent_id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5"
}'Ejemplo de respuesta (200)OK
{
"data": {
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"status": "ACTIVE",
"status_reason": "CLIENT_INTERNAL_REASON",
"pin": "1234",
"parent_id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5"
}
}