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

API original de Incomm vs Adaptador de la API de Fluz

URL base

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

Incomm original

Usa Autenticación Bearer con el encabezado Authorization; es necesario generar primero el 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 la API de Fluz

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

Authorization: Basic <FLUZ-API-Key>

Comparación de Endpoints de la API

Operación	Endpoint de Incomm	Endpoint de Fluz	Notas
Obtener detalles de la orden	`GET /orders/:orderId/cards`	`GET /orders/:orderId/cards`	Recupera los detalles de las tarjetas para una orden específica
Obtener orden	`GET /orders/:orderId`	`GET /orders/:orderId`	Recupera los detalles de una orden específica
Crear orden	`POST /orders/immediate`	`POST /orders/immediate`	Crea una nueva orden de tarjeta de regalo
Obtener balance	`GET /programs/programs/:programId/programbalance`	`GET /programs/programs/:programId/programbalance`	Obtiene el balance para todas las monedas

Ejemplos de solicitudes

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 la 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
        }
      ]
    }
  ]
}

Procesamiento en segundo plano para órdenes de Incomm

Todas las operaciones de compra a través de la integración con Incomm se procesan como operaciones en segundo plano. Sin embargo, para mantener la compatibilidad con el comportamiento de la API de Incomm, el Adaptador de la API de Fluz puede devolver resultados completos de forma síncrona por defecto.

Nota: Incluso cuando los resultados parecen síncronos, todas las compras siguen programadas y se rastrean como operaciones en segundo plano internamente para mejorar la confiabilidad y un mejor manejo de reintentos.

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 balance

# Get Balance with Incomm via Fluz API Adapter
curl -X GET "https://api-adapter.staging.fluzapp.com/incomm/v1/balance" \
  -H "Authorization: Basic <FLUZ-API-Key>"

Ejemplo 4: Crear una nueva orden

# Create Order with Incomm via Fluz API Adapter
# Note: This operation runs as a background process but may return complete results
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 la API de Fluz

URL base

Incomm original

Adaptador de la API de Fluz

Comparación de Endpoints de la API

Ejemplos de solicitudes

Crear orden

Solicitud original de Incomm:

Solicitud del Adaptador de la API de Fluz:

Procesamiento en segundo plano para órdenes de Incomm

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 balance

Ejemplo 4: Crear una nueva orden

​API original de Incomm vs Adaptador de la API de Fluz

​URL base

​Incomm original

​Adaptador de la API de Fluz

​Comparación de Endpoints de la API

​Ejemplos de solicitudes

​Crear orden

​Solicitud original de Incomm:

​Solicitud del Adaptador de la API de Fluz:

​Procesamiento en segundo plano para órdenes de Incomm

​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 balance

​Ejemplo 4: Crear una nueva orden

API original de Incomm vs Adaptador de la API de Fluz

URL base

Incomm original

Adaptador de la API de Fluz

Comparación de Endpoints de la API

Ejemplos de solicitudes

Crear orden

Solicitud original de Incomm:

Solicitud del Adaptador de la API de Fluz:

Procesamiento en segundo plano para órdenes de Incomm

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 balance

Ejemplo 4: Crear una nueva orden