Gift cards
POST
Listar gift cards
POST /api/gift-cards/list-gift-cards
Descripción
Listado paginado de las gift cards vendidas por el negocio.
Detalles
Devuelve las gift cards con su saldo disponible, estado, fecha de emisión y vencimiento. Acepta búsqueda por código y filtros por estado y disponibilidad. Incluye totales resumidos.
Permisos requeridos
finance.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
| status | string | No |
enum:active,redeemed,expired,cancelled
|
| isAvailable | bool | No | — |
Paginación
| defaultLimit | 25 |
| maxLimit | 100 |
| defaultDir | desc |
| withTotal | true |
| allowedSorts | [createdAt, currentBalanceCents, code] |
Ejemplo de request
curl -X POST https://restofy.pro/api/gift-cards/list-gift-cards \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"giftCards": [
{
"prepaidAccountId": 4,
"prepaidUuid": "46177c94-ab4a-11f1-b72d-f2569efa6eee",
"accountId": 9115,
"code": "GC-BFAF8FCB",
"currentBalanceCents": 10000,
"initialAmountCents": 10000,
"status": "active",
"isAvailable": 1,
"partyId": null,
"partyName": null,
"createdAt": "2026-09-08T16:31:55.000Z",
"expiresAt": null
},
{
"prepaidAccountId": 3,
"prepaidUuid": "45901924-ab4a-11f1-b72d-f2569efa6eee",
"accountId": 9114,
"code": "GC-3652912E",
"currentBalanceCents": 25000,
"initialAmountCents": 25000,
"status": "active",
"isAvailable": 1,
"partyId": null,
"partyName": null,
"createdAt": "2026-09-08T16:31:54.000Z",
"expiresAt": null
},
{
"prepaidAccountId": 2,
"prepaidUuid": "45107a9d-ab4a-11f1-b72d-f2569efa6eee",
"accountId": 9113,
"code": "GC-BC608C5B",
"currentBalanceCents": 50000,
"initialAmountCents": 50000,
"status": "active",
"isAvailable": 1,
"partyId": null,
"partyName": null,
"createdAt": "2026-09-08T16:31:53.000Z",
"expiresAt": null
},
{
"prepaidAccountId": 1,
"prepaidUuid": "245625a6-ab4a-11f1-b72d-f2569efa6eee",
"accountId": 82,
"code": "SEED01",
"currentBalanceCents": 0,
"initialAmountCents": 5000000,
"status": "active",
"isAvailable": 1,
"partyId": null,
"partyName": null,
"createdAt": "2026-09-08T16:30:58.000Z",
"expiresAt": null
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 4,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
},
"stats": {
"totalCount": 4,
"activeCount": "4",
"outstandingBalanceCents": "85000",
"totalIssuedCents": "5085000"
}
}
}