Saltar al contenido principal

Tarjetas de Regalo

Listar tarjetas

GET /admin/gift-cards

Parámetros:

NombreTipoDescripción
statusstringactive (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"
}
CampoRequeridoTipoDescripción
amountfloat64Monto en unidades monetarias
currencynostringMoneda (default: PEN)
notenostringNota interna
expires_atnodateFecha 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