Tarjetas de regalo
POST
Vender gift card
POST /api/gift-cards/create-gift-card
Descripción
Vende una gift card por el monto indicado y devuelve el código asignado al portador.
Detalles
Genera una gift card nueva con código automático y registra el saldo a favor del portador por el monto cobrado. El dinero ingresa según el medio de pago elegido. La venta se realiza desde una caja con sesión abierta. Puede pedir PIN según la configuración del negocio.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| amountCents | int | Sí |
min_value:1
|
| paymentMethodId | int | Sí |
min_value:1
|
| cashRegisterSessionId | int | Sí |
min_value:1
|
| notes | string | No |
max:500
|
| expiresAt | datetime | No | — |
| pin | string | No |
max:60
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/gift-cards/create-gift-card \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"amountCents": 1,
"paymentMethodId": 1,
"cashRegisterSessionId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"amountCents": 40000,
"paymentMethodId": 1,
"cashRegisterSessionId": 2,
"notes": "test sell"
}Response
{
"success": true,
"message": "Gift card vendida",
"data": {
"prepaidAccountId": "2",
"code": "GC-F2EA5C49",
"amountCents": 40000
}
}