Tarjetas de regalo
POST
Anular gift card
POST /api/gift-cards/cancel-gift-card
Descripción
Anula una gift card revirtiendo su saldo vigente, devolviéndolo o dejándolo como ingreso.
Detalles
Revierte el saldo que aún tiene la gift card. Si se devuelve, el dinero sale de la cuenta elegida: una caja con sesión abierta, una cuenta bancaria o una caja fuerte. Si queda como ingreso, el saldo se imputa a la cuenta de ingreso configurada para ese fin. Lo que el portador ya había consumido no se modifica.
Permisos requeridos
finance.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| prepaidAccountId | int | Sí |
min_value:1
|
| cancellationType | string | Sí |
in:refund,income
|
| refundAccountId | int | No |
min_value:1
|
| cashRegisterSessionId | int | No |
min_value:1
|
| reason | string | No |
max:200
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/gift-cards/cancel-gift-card \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"prepaidAccountId": 1,
"cancellationType": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"prepaidAccountId": "2",
"cancellationType": "refund",
"cashRegisterSessionId": 2,
"reason": "test refund"
}Response
{
"success": true,
"message": "Gift card anulada",
"data": {
"prepaidAccountId": 2,
"journalEntryId": "2",
"balanceCents": 50000
}
}