API Workflows

Bulk Gift Card Distribution

Send high volumes of gift card rewards efficiently for campaigns, outreach, and large-scale incentive programs.

Overview

Common bulk distribution scenarios include:

  • Large-scale incentive programs
  • Employee reward campaigns
  • Customer promotions and outreach
  • Survey participant payouts
  • Seasonal or event-based distributions

Rewards can be sent in batches rather than one at a time, improving efficiency.

How the API is Used

  • Send multiple rewards in a single request
  • Process large volumes of gift cards efficiently
  • Combine multiple recipients and line items
  • Track fulfillment status across bulk orders

Example Workflow

  • Organization prepares a list of recipients
  • System formats rewards into batch order or orders
  • Your system submits a bulk request via API
  • Rewards are processed and delivered to recipients

API Integration Flow

API Integration Flow

1
Authenticate
POST /v1/Tokens
2
Retrieve products
GET /v1/Products
3
Send bulk order
POST /v1/Orders
4
Track status
GET /v1/Orders/{id}or webhook

Example Request

JSON
{
  "Type": "DigitalDelivery",
  "LineItems": [
    {
      "ProductId": "CVS",
      "Value": 10,
      "Quantity": 3,
      "DigitalDeliveryAddress": {
        "Email": "user1@email.com"
      }
    },
    {
      "ProductId": "CVS",
      "Value": 10,
      "Quantity": 2,
      "DigitalDeliveryAddress": {
        "Email": "user2@email.com"
      }
    }
  ],
  "PONumber": "BULK-12001"
}

Delivery Options

  • DigitalDelivery – Send gift cards via email or SMS
  • Links – Generate claim links for distribution lists
  • PhysicalShipment – Ship physical gift cards in bulk

Benefits

  • Enables high-volume reward distribution
  • Reduces operational overhead
  • Supports campaign-based delivery
  • Improves efficiency for large programs

Compliance Considerations

  • Ensure recipient data accuracy before submission
  • Maintain records for bulk transactions
  • Monitor funding balance for large orders

Common Program Types

  • Mass incentive campaigns
  • Employee bonus distributions
  • Customer outreach programs
  • Survey payouts

Related Use Cases