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>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-13T21:05:19Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"giftCards": [
{
"prepaidAccountId": 4,
"prepaidUuid": "200b8879-acb4-11f1-b72d-f2569efa6eee",
"accountId": 9115,
"code": "GC-E195F7E9",
"currentBalanceCents": 10000,
"initialAmountCents": 10000,
"status": "active",
"isAvailable": 1,
"partyId": null,
"partyName": null,
"createdAt": "2026-09-13T21:01:34.000Z",
"expiresAt": null
},
{
"prepaidAccountId": 2,
"prepaidUuid": "1f0299ef-acb4-11f1-b72d-f2569efa6eee",
"accountId": 9113,
"code": "GC-2068883F",
"currentBalanceCents": 50000,
"initialAmountCents": 50000,
"status": "active",
"isAvailable": 1,
"partyId": null,
"partyName": null,
"createdAt": "2026-09-13T21:01:33.000Z",
"expiresAt": null
},
{
"prepaidAccountId": 3,
"prepaidUuid": "1f7f6fa6-acb4-11f1-b72d-f2569efa6eee",
"accountId": 9114,
"code": "GC-1BF4ADD2",
"currentBalanceCents": 25000,
"initialAmountCents": 25000,
"status": "active",
"isAvailable": 1,
"partyId": null,
"partyName": null,
"createdAt": "2026-09-13T21:01:33.000Z",
"expiresAt": null
},
{
"prepaidAccountId": 1,
"prepaidUuid": "01e0d097-acb4-11f1-b72d-f2569efa6eee",
"accountId": 82,
"code": "SEED01",
"currentBalanceCents": 0,
"initialAmountCents": 5000000,
"status": "active",
"isAvailable": 1,
"partyId": null,
"partyName": null,
"createdAt": "2026-09-13T21:00:44.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"
}
}
}