Tarjetas de Regalo
Listar tarjetas
GET /admin/gift-cards
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
status | string | active (default), disabled, all |
Respuesta 200:
{
"data": [
{
"id": "uuid",
"code": "GIFT-ABCD-1234",
"initial_balance": 10000,
"current_balance": 7500,
"currency": "PEN",
"status": "active",
"note": "Regalo de cumpleaños",
"expires_at": "2027-04-08T00:00:00Z",
"created_at": "2026-04-08T12:00:00Z"
}
]
}
Crear tarjeta
POST /admin/gift-cards
{
"amount": 100.00,
"currency": "PEN",
"note": "Regalo de cumpleaños",
"expires_at": "2027-04-08"
}
| Campo | Requerido | Tipo | Descripción |
|---|---|---|---|
amount | sí | float64 | Monto en unidades monetarias |
currency | no | string | Moneda (default: PEN) |
note | no | string | Nota interna |
expires_at | no | date | Fecha de expiración |
Detalle de tarjeta
GET /admin/gift-cards/:id
Incluye historial de uso (órdenes donde se aplicó).
Deshabilitar tarjeta
POST /admin/gift-cards/:id/disable