Entrar

Cancelar card

POST https://{organization}.myguper.com/api/loyalty/cards/{id}/cancel

Cancela un card. El card sale de circulacion de inmediato: deja de contar como saldo, deja de ser canjeable y se lee como canceled en todas partes.

El card no tiene columna de estado - canceled se deriva de la fecha de cancelacion, por lo que este endpoint es lo que significa "cambiar el estado del card a cancelado".

Cancelar un card es un cambio de estado, no un movimiento de dinero: el saldo no se debita ni se devuelve, y no entra ninguna linea al ledger de flow del card. El card simplemente sale de todas las consultas de saldo. Elija la operacion segun la intencion:

  • el card completo debe dejar de existir para el cliente - este endpoint;
  • el valor debe salir de un card que sigue vivo - Ajustar saldo del card (manual_debit, registrado en el ledger);
  • la compra se revirtio y su cashback debe irse con ella - cancele la transaccion, no el card.

Reversible con Reactivar card.

Un card con reserva de canje abierta se rechaza con 409: el valor reservado ya fue debitado y espera liquidacion o devolucion, asi que cancelar el card lo dejaria atrapado. Resuelva la reserva primero.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

Send your user token in the x-guper-authorization header. Endpoints that support a Public mode (e.g. acúmulo and resgate previews) accept the same request without the header — Private mode adds customer data and a confirmation token to the response.

Encabezados

Name Type Description
x-guper-authorization * string User token issued by Guper. Omit only on endpoints that explicitly support a Public mode.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Parámetros de ruta

Name Type Description
id * integer Card id, as returned by the card endpoints.

Respuestas

{
    "cardId": 95980,
    "canceledAt": "2026-11-09T14:32:05-03:00",
    "cardStatus": "canceled",
    "amount": 1250
}

Relacionados

Copied to clipboard