Ver tarjetas de regalo

1. Recuperar la lista de órdenes de tarjetas de regalo — Puedes omitir este paso si acabas de comprar una tarjeta de regalo y ya tienes el giftCardId.
2. Revelar los detalles de la tarjeta de regalo — Usa la mutación revealGiftCardByGiftCardId para revelar los detalles de canje de la tarjeta de regalo.

​

Paso 1: Recuperar la lista de órdenes de tarjetas de regalo

📘 Conciliación de tarjetas de regalo con tus órdenes getGiftCards devuelve purchaseId (el mismo UUID devuelto por purchaseGiftCard y getUserPurchases), purchaseDisplayId (el ID corto de la transacción de Fluz, p. ej. 1047283), y el valor de la orden mediante purchaseValue / currentValue / currency. Úsalos para mapear cada giftCardId a su orden y monto de origen sin tener que revelar cada tarjeta.

​

Consulta de ejemplo

query GetGiftCards {
  getGiftCards(
    paginate: { limit: 20, offset: 0 }
  ) {
    giftCardId
    purchaseId
    purchaseDisplayId
    purchaserUserId
    endDate
    status
    purchaseValue
    currentValue
    currency
    createdAt
    deliveryFormat
    termsAndConditions
    merchant {
      merchantId
      name
      slug
    }
  }
}

​

Argumentos de la consulta

• status — Si quieres filtrar las tarjetas de regalo por estado.
• userCashBalanceId — Si quieres filtrar tarjetas de regalo por el saldo en efectivo (cuenta de gasto).
• paginate — Campos de paginación
  • paginate.limit — Cantidad máxima de tarjetas de regalo por página
  • paginate.offset — La cantidad de registros que se debe omitir

​

Respuesta de ejemplo

{
  "data": {
    "getGiftCards": [
      {
        "giftCardId": "7c57c381-4b19-49e4-bbb0-404a45166ee4",
        "purchaseId": "785f57ff-f756-4f5c-afca-b896881e3e87",
        "purchaseDisplayId": "1047283",
        "purchaserUserId": "7c57c381-4b19-49e4-bbb0-404a45166ee4",
        "endDate": "2007-12-03T10:15:30Z",
        "status": "ACTIVE",
        "purchaseValue": 25,
        "currentValue": 25,
        "currency": "USD",
        "createdAt": "2007-12-03T10:15:30Z",
        "deliveryFormat": "PIN_WITH_URL",
        "termsAndConditions": "Except as required by law, Gift Cards cannot be transferred for...",
        "merchant": {
          "merchantId": "123",
          "name": "Merchant",
          "slug": "merchant"
        }
      }
    ]
  }
}

​

Campos de la respuesta

📘 Prefiere deliveryFormat de getGiftCards sobre getMerchants La oferta activa de un comercio puede cambiar con el tiempo. El formato bajo el cual se compró la tarjeta de regalo puede diferir de la oferta activa actual del comercio, así que siempre usa el deliveryFormat devuelto por getGiftCards al decidir cómo mostrar los detalles de canje de revealGiftCardByGiftCardId.

​

Paso 2: Revelar detalles de la tarjeta de regalo

​

Entrada

​

Mutación de ejemplo

mutation RevealGiftCardByGiftCardId {
  revealGiftCardByGiftCardId(
    giftCardId: "86dd5fcf-fea3-4531-aa5d-1d196957f7d7"
  ) {
    code
    pin
    url
    termsAndConditions
  }
}

​

Respuesta de ejemplo

{
  "data": {
    "revealGiftCardByGiftCardId": {
      "code": "9877890000000000",
      "pin": "2014",
      "url": null,
      "termsAndConditions": "Except as required by law, Gift Cards cannot be transferred for..."
    }
  }
}

📘 No todas las tarjetas de regalo de los comercios tienen códigos, PIN y URL Dependiendo del comercio y del socio, los detalles de la tarjeta de regalo pueden variar. Algunos comercios usan un código alfanumérico y no proporcionan un PIN con su tarjeta de regalo. Algunos comercios o socios solo proporcionan una URL en lugar de un código y PIN. Fluz siempre transmitirá toda la información que recibimos de los comercios en cada orden de tarjeta de regalo.

​

Estrategia de sondeo recomendada

• Demora inicial: 300 ms
• Estrategia de backoff: Exponencial (p. ej. 300 ms → 600 ms → 1200 ms → 2400 ms → …)
• Demora máxima: 180000 ms (3 minutos)
• Deja de sondear una vez que los detalles de la tarjeta de regalo se devuelvan correctamente