Detalle de gift card — Restofy Docs

Descripción

Devuelve una gift card con su saldo y sus últimos movimientos.

Detalles

Retorna saldo disponible, estado, fechas de emisión y vencimiento y los últimos 50 movimientos que afectaron el saldo (ventas, consumos y ajustes).

Permisos requeridos

finance.module

Request

Nombre	Tipo	Requerido	Reglas
prepaidAccountId	int	Sí	min_value:1

Ejemplo de request

curl -X POST https://app.restofy.co/api/gift-cards/get-gift-card \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "prepaidAccountId": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z

HTTP 200

Request

{
    "prepaidAccountId": "2"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "giftCard": {
            "prepaidAccountId": 2,
            "prepaidUuid": "9471af47-7eb3-11f1-ac02-f2368af4d8ac",
            "accountId": 9113,
            "code": "GC-06DEA2C6",
            "currentBalanceCents": 0,
            "initialAmountCents": 50000,
            "notes": "test sell",
            "status": "cancelled",
            "isAvailable": 1,
            "partyId": null,
            "partyName": null,
            "createdByActorId": 15,
            "cashRegisterSessionId": 2,
            "createdAt": "2026-07-15T13:18:58.000Z",
            "expiresAt": null
        },
        "movements": [
            {
                "entryCode": "GIFTCARD-20260715-13182F59",
                "entryType": "gift_card_cancel",
                "description": "Anulación gift card GC-06DEA2C6 - devolución",
                "status": "normal",
                "occurredAt": "2026-07-15T13:18:58.000Z",
                "debitCents": 50000,
                "creditCents": 0
            },
            {
                "entryCode": "GIFTCARD-20260715-F1F49CC8",
                "entryType": "gift_card_issue",
                "description": "Venta gift card GC-06DEA2C6",
                "status": "normal",
                "occurredAt": "2026-07-15T13:18:58.000Z",
                "debitCents": 0,
                "creditCents": 50000
            }
        ]
    }
}