> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.recurrente.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recurrente.com/_mcp/server.

# Tarjeta de regalo canjeada

POST 

Se emite cuando la tarjeta paga parte o todo de un checkout, o un canje en mostrador (`POST /gift_cards/{gift_card_id}/redemption`). `transaction.account_id` es la sucursal que la tomó.

Reference: https://docs.recurrente.com/referencia-api/api-reference/webhook-events/gift-card-redeem-webhook

## Request

### Payload

- `event_type` (string, required) — Tipo exacto del evento enviado por Recurrente.
- `id` (string, required)
- `api_version` (string, required)
- `transaction` (GiftCardTransaction, required) — Un movimiento del saldo de una tarjeta. `amount_in_cents` lleva signo (un canje es negativo).
- `connected` (boolean, optional, nullable) — Presente como `true` cuando el evento proviene de una cuenta conectada.
- `account_id` (string, optional, nullable) — La cuenta que la vendió.
- `code` (string, optional) — El código que se canjea. Es un secreto al portador.
- `status` (enum, optional)
  - Allowed values: `active`, `depleted`, `expired`, `voided`
- `currency` (string, optional)
- `initial_amount_in_cents` (integer, optional)
- `balance_in_cents` (integer, optional)
- `expires_on` (date, optional, nullable)
- `recipient` (GiftCardWebhookRecipient, optional)
- `message` (string, optional, nullable)
- `deliver_on` (date, optional, nullable)
- `delivered_at` (datetime, optional, nullable)
- `purchaser` (GiftCardWebhookPurchaser, optional)
- `checkout_id` (string, optional, nullable) — El checkout que la vendió.
- `public_url` (string, optional) — La página de saldo de la tarjeta, la que abre su QR.
- `transactions` (list of GiftCardTransaction, optional) — Sus movimientos, del más viejo al más nuevo.
- `created_at` (datetime, optional)

## Types

### GiftCardTransaction

Un movimiento del saldo de una tarjeta. `amount_in_cents` lleva signo (un canje es negativo).

- `id` (string, optional)
- `kind` (enum, optional)
  - Allowed values: `issue`, `redeem`, `release`, `reload`, `refund_back`, `adjust`, `expire`, `void`, `refund_void`
- `amount_in_cents` (integer, optional)
- `balance_after_in_cents` (integer, optional)
- `currency` (string, optional)
- `account_id` (string, optional) — La cuenta (sucursal) donde ocurrió.
- `checkout_id` (string, optional, nullable)
- `note` (string, optional, nullable)
- `created_at` (datetime, optional)

### GiftCardWebhookRecipient

- `name` (string, optional, nullable)
- `email` (string, optional, nullable)
- `phone` (string, optional, nullable)

### GiftCardWebhookPurchaser

- `name` (string, optional, nullable)
- `email` (string, optional, nullable)