Tarjetas de regalo
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://app.restofy.co/api/gift-cards/get-gift-card-by-code \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"code": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"code": "SEED01"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"giftCard": {
"prepaidAccountId": 1,
"accountId": 82,
"code": "SEED01",
"currentBalanceCents": 0,
"status": "active",
"expiresAt": null
}
}
}