Este documento proporciona detalles específicos para usar el Conector de API de Proveedor de Tarjetas de Regalo de Fluz con Incomm como proveedor.

API original de Incomm vs Adaptador de API de Fluz

URL base

API original de Incomm: https://app.giftango.com
Adaptador de API de Fluz:
- Staging: https://api-adapter.staging.fluzapp.com/incomm
- Producción: https://api-adapter.fluzapp.com/incomm

Incomm original

Usa Autenticación Bearer con el encabezado Authorization; primero necesitas generar un token de autorización.

Authorization: Bearer <INCOMM-AUTH-TOKEN>

Para generar el AuthToken envía una solicitud al endpoint /auth/token con el cuerpo:

{
  grant_type: 'client_credentials',
  client_id: INCOMM_CLIENT_ID,
  client_secret: INCOMM_SECRET_KEY,
}

Adaptador de API de Fluz

Usa Autenticación Básica con el encabezado Authorization (igual que todas las integraciones de proveedores).

Authorization: Basic <FLUZ-API-Key>

Comparación de endpoints de API

Operación	Endpoint de Incomm	Endpoint de Fluz	Notas
Obtener detalles de la orden	`GET /orders/:orderId/cards`	`GET /v1/orders/:orderId/cards`	Recupera los detalles de la tarjeta para una orden específica
Obtener orden	`GET /orders/:orderId`	`GET /v1/orders/:orderId`	Recupera detalles de una orden específica
Crear orden	`POST /orders/immediate`	`POST /v1/orders/immediate`	Crea una nueva orden de tarjeta de regalo
Obtener saldo	`GET /programs/programs/:programId/programbalance`	`GET /v1/programs/programs/:programId/programbalance`	Obtén el saldo de tu cuenta. Alcanzado al nivel de la cuenta para la que se emitió tu clave

Ejemplos de solicitud

Crear orden

Solicitud original de Incomm:

{
  "PurchaseOrderNumber": "cddabd6d-1f7a-483d-8126-8bc676f7bd63",
  "CustomerOrderId": "cddabd6d-1f7a-483d-8126-8bc676f7bd63",
  "Recipients": [
    {
      "FirstName": "testFirstName",
      "LastName": "testLastName",
      "EmailAddress": "testEmail@test.com",
      "DeliverEmail": false,
      "Products": [
        {
          "Sku": "VUSA-D-2500-00",
          "Quantity": 1,
          "Value": 25
        }
      ]
    }
  ]
}

Solicitud del Adaptador de API de Fluz:

{
  "PurchaseOrderNumber": "cddabd6d-1f7a-483d-8126-8bc676f7bd63",
  "CustomerOrderId": "cddabd6d-1f7a-483d-8126-8bc676f7bd63",
  "Recipients": [
    {
      "FirstName": "testFirstName",
      "LastName": "testLastName",
      "EmailAddress": "testEmail@test.com",
      "DeliverEmail": false,
      "Products": [
        {
          "Sku": "VUSA-D-2500-00",
          "Quantity": 1,
          "Value": 25
        }
      ]
    }
  ]
}

Una orden cubre un destinatario y un producto. DeliverEmail no debe ser true, porque Fluz devuelve las credenciales de la tarjeta de regalo en la respuesta de la orden en lugar de enviar un correo electrónico al destinatario, lo que mantiene la entrega bajo tu control. PurchaseOrderNumber y CustomerOrderId se mantienen para compatibilidad con la forma de tu solicitud existente; correlaciona una orden usando los identificadores que devuelve Fluz.

Tiempos de respuesta

La creación de la orden es sincrónica y siempre se ejecuta hasta completarse. La llamada no regresa hasta que la compra haya finalizado, lo que puede tomar hasta 150 segundos, así que establece el tiempo de espera de lectura de tu cliente por encima de eso.

Los valores de estado de la orden son de Fluz, no de Incomm. OrderStatus devuelve PENDING, IN_PROGRESS, COMPLETED, FAILED o CANCELED. Consulta Comportamiento del conector para valores de estado, respuestas de error, límites y restricciones de solicitud.

Ejemplo de uso con cURL

Ejemplo 1: Obtener una orden específica con tarjetas de regalo

# Get gift cards from order with Incomm via Fluz API Adapter
curl -X GET "https://api-adapter.staging.fluzapp.com/incomm/v1/orders/353a4151-2d51-48b6-81c9-90fd6815f12b/cards" \
  -H "Authorization: Basic <FLUZ-API-Key>"

Ejemplo 2: Obtener detalles de la orden

# Get order details with Incomm via Fluz API Adapter
curl -X GET "https://api-adapter.staging.fluzapp.com/incomm/v1/orders/353a4151-2d51-48b6-81c9-90fd6815f12b" \
  -H "Authorization: Basic <FLUZ-API-Key>"

Ejemplo 3: Obtener saldo

# Get Balance with Incomm via Fluz API Adapter
# The balance is scoped to your key's account, so any :programId value works
curl -X GET "https://api-adapter.staging.fluzapp.com/incomm/v1/programs/programs/0/programbalance" \
  -H "Authorization: Basic <FLUZ-API-Key>"

Ejemplo 4: Crear una nueva orden

# Create Order with Incomm via Fluz API Adapter
# Note: this call blocks until the purchase completes. Allow up to 150 seconds.
curl -X POST "https://api-adapter.staging.fluzapp.com/incomm/v1/orders/immediate" \
  -H "Authorization: Basic <FLUZ-API-Key>" \
  -H "Content-Type: application/json" \
  -d '{
  "PurchaseOrderNumber": "cddabd6d-1f7a-483d-8126-8bc676f7bd63",
  "CustomerOrderId": "cddabd6d-1f7a-483d-8126-8bc676f7bd63",
  "Recipients": [
    {
      "FirstName": "testFirstName",
      "LastName": "testLastName",
      "EmailAddress": "testEmail@test.com",
      "DeliverEmail": false,
      "Products": [
        {
          "Sku": "VUSA-D-2500-00",
          "Quantity": 1,
          "Value": 25
        }
      ]
    }
  ]
}'

Desarrolladores

Recetas

Incomm

API original de Incomm vs Adaptador de API de Fluz

URL base

Incomm original

Adaptador de API de Fluz

Comparación de endpoints de API

Ejemplos de solicitud

Crear orden

Solicitud original de Incomm:

Solicitud del Adaptador de API de Fluz:

Tiempos de respuesta

Ejemplo de uso con cURL

Ejemplo 1: Obtener una orden específica con tarjetas de regalo

Ejemplo 2: Obtener detalles de la orden

Ejemplo 3: Obtener saldo

Ejemplo 4: Crear una nueva orden

​API original de Incomm vs Adaptador de API de Fluz

​URL base

​Incomm original

​Adaptador de API de Fluz

​Comparación de endpoints de API

​Ejemplos de solicitud

​Crear orden

​Solicitud original de Incomm:

​Solicitud del Adaptador de API de Fluz:

​Tiempos de respuesta

​Ejemplo de uso con cURL

​Ejemplo 1: Obtener una orden específica con tarjetas de regalo

​Ejemplo 2: Obtener detalles de la orden

​Ejemplo 3: Obtener saldo

​Ejemplo 4: Crear una nueva orden

API original de Incomm vs Adaptador de API de Fluz

URL base

Incomm original

Adaptador de API de Fluz

Comparación de endpoints de API

Ejemplos de solicitud

Crear orden

Solicitud original de Incomm:

Solicitud del Adaptador de API de Fluz:

Tiempos de respuesta

Ejemplo de uso con cURL

Ejemplo 1: Obtener una orden específica con tarjetas de regalo

Ejemplo 2: Obtener detalles de la orden

Ejemplo 3: Obtener saldo

Ejemplo 4: Crear una nueva orden