Gift cards
POST
Detalle de gift card
POST /api/gift-cards/get-gift-card
Descripción
Devuelve una gift card con su saldo y sus últimos movimientos.
Detalles
Retorna saldo disponible, estado, fechas de emisión y vencimiento y los últimos 50 movimientos que afectaron el saldo (ventas, consumos y ajustes).
Permisos requeridos
finance.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| prepaidAccountId | int | Sí |
min_value:1
|
Ejemplo de request
curl -X POST https://restofy.pro/api/gift-cards/get-gift-card \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"prepaidAccountId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"prepaidAccountId": "2"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"giftCard": {
"prepaidAccountId": 2,
"prepaidUuid": "44cc6c39-ab4a-11f1-b72d-f2569efa6eee",
"accountId": 9113,
"code": "GC-8E96D842",
"currentBalanceCents": 0,
"initialAmountCents": 50000,
"notes": "test sell",
"status": "cancelled",
"isAvailable": 1,
"partyId": null,
"partyName": null,
"createdByActorId": 15,
"cashRegisterSessionId": 2,
"createdAt": "2026-09-08T16:31:53.000Z",
"expiresAt": null
},
"movements": [
{
"entryCode": "GIFTCARD-20260908-096F1ED1",
"entryType": "gift_card_cancel",
"description": "Anulación gift card GC-8E96D842 - devolución",
"status": "normal",
"occurredAt": "2026-09-08T16:31:54.000Z",
"debitCents": 50000,
"creditCents": 0
},
{
"entryCode": "GIFTCARD-20260908-9CB38F6F",
"entryType": "gift_card_issue",
"description": "Venta gift card GC-8E96D842",
"status": "normal",
"occurredAt": "2026-09-08T16:31:53.000Z",
"debitCents": 0,
"creditCents": 50000
}
]
}
}