This document provides specific details for using the Fluz Gift Card Vendor API Connector with Incomm as the vendor.

Original Incomm API vs Fluz API Adapter

Base URL

Original Incomm API: https://app.giftango.com
Fluz API Adapter:
- Staging: https://api-adapter.staging.fluzapp.com/incomm

Original Incomm

Uses Bearer Authentication with the Authorization header - need to generate authorization token first.

Authorization: Bearer <INCOMM-AUTH-TOKEN>

To generate AuthToken send request to /auth/token endpoint with body:

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

Fluz API Adapter

Uses Basic Authentication with the Authorization header (same as all vendor integrations).

Authorization: Basic <FLUZ-API-Key>

API Endpoint Comparison

Operation	Incomm Endpoint	Fluz Endpoint	Notes
Get Order Details	`GET /orders/:orderId/cards`	`GET /orders/:orderId/cards`	Retrieve card details for a specific order
Get Order	`GET /orders/:orderId`	`GET /orders/:orderId`	Retrieve details for a specific order
Create Order	`POST /orders/immediate`	`POST /orders/immediate`	Create a new gift card order
Get Balance	`GET /programs/programs/:programId/programbalance`	`GET /programs/programs/:programId/programbalance`	Get balance for all currencies

Request Examples

Create Order

Original Incomm Request:

{
  "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
        }
      ]
    }
  ]
}

Fluz API Adapter Request:

{
  "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
        }
      ]
    }
  ]
}

Background Processing for Incomm Orders

All purchase operations through the Incomm integration are processed as background operations. However, for compatibility with Incomm API behavior, the Fluz API Adapter may return full results synchronously by default.

Note: Even when results appear synchronous, all purchases are still scheduled and tracked as background operations internally for improved reliability and better handling of retries.

Example Usage with cURL

Example 1: Get a Specific Order with Gift Cards

# 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>"

Example 2: Get Order Details

# 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>"

Example 3: Get 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>"

Example 4: Create a New Order

# 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
        }
      ]
    }
  ]
}'

Developers

Recipes

Incomm

Original Incomm API vs Fluz API Adapter

Base URL

Original Incomm

Fluz API Adapter

API Endpoint Comparison

Request Examples

Create Order

Original Incomm Request:

Fluz API Adapter Request:

Background Processing for Incomm Orders

Example Usage with cURL

Example 1: Get a Specific Order with Gift Cards

Example 2: Get Order Details

Example 3: Get Balance

Example 4: Create a New Order

​Original Incomm API vs Fluz API Adapter

​Base URL

​Original Incomm

​Fluz API Adapter

​API Endpoint Comparison

​Request Examples

​Create Order

​Original Incomm Request:

​Fluz API Adapter Request:

​Background Processing for Incomm Orders

​Example Usage with cURL

​Example 1: Get a Specific Order with Gift Cards

​Example 2: Get Order Details

​Example 3: Get Balance

​Example 4: Create a New Order

Original Incomm API vs Fluz API Adapter

Base URL

Original Incomm

Fluz API Adapter

API Endpoint Comparison

Request Examples

Create Order

Original Incomm Request:

Fluz API Adapter Request:

Background Processing for Incomm Orders

Example Usage with cURL

Example 1: Get a Specific Order with Gift Cards

Example 2: Get Order Details

Example 3: Get Balance

Example 4: Create a New Order