Gift cards
POST
Consultar gift card por código
POST /api/gift-cards/get-gift-card-by-code
Descripción
Retorna el saldo y estado de una gift card a partir de su código.
Detalles
Consulta puntual de una gift card por su código. Devuelve el saldo vigente, el estado y la fecha de vencimiento si tiene. Falla si el código no corresponde a ninguna gift card registrada.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| code | string | Sí |
min:1
max:50
|
Ejemplo de request
curl -X POST https://restofy.pro/api/gift-cards/get-gift-card-by-code \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"code": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"code": "GC-3652912E"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"giftCard": {
"prepaidAccountId": 3,
"accountId": 9114,
"code": "GC-3652912E",
"currentBalanceCents": 25000,
"status": "active",
"expiresAt": null
}
}
}