API Workflows

Physical Gift Card Fulfillment

Automate physical gift card orders and shipping for programs that require a tangible reward experience.

Overview

Common physical fulfillment scenarios include:

  • Employee milestone or anniversary rewards
  • Customer gifting programs
  • Direct mail campaigns
  • High-value incentive programs
  • Programs requiring tangible rewards

Physical gift cards provide a more traditional and tangible reward experience compared to digital options.

How the API is Used

  • Order physical gift cards programmatically
  • Provide shipping details for recipients
  • Select shipping methods and carriers
  • Track fulfillment and delivery status

Example Workflow

  • Recipient qualifies for a reward
  • Your system collects shipping details
  • Your system triggers a physical order via the API
  • The gift card is shipped to the recipient

API Integration Flow

API Integration Flow

1
Authenticate
POST /v1/Tokens
2
Retrieve products
GET /v1/Products
3
Retrieve shipping methods
GET /v1/ShippingMethods
4
Send reward
POST /v1/Orders (PhysicalShipment)
5
Track status
GET /v1/Orders/{id}or webhook

Example Request

JSON
{
  "Type": "PhysicalShipment",
  "LineItems": [
    {
      "ProductId": "CVS",
      "Value": 50,
      "Quantity": 1,
      "PhysicalDeliveryAddress": {
        "ShippingMethodId": "STANDARD",
        "CarrierId": "DEFAULT",
        "Name": "Recipient Name",
        "AddressLine1": "123 Main Street",
        "City": "New York",
        "State": "NY",
        "Zip": "10001",
        "Country": "US"
      }
    }
  ],
  "PONumber": "PHYSICAL-15001"
}

Delivery Options

  • PhysicalShipment – Ship physical gift cards to recipient addresses
  • DigitalDelivery – Send digital gift cards via email or SMS
  • Links – Generate claim links for flexible distribution

Benefits

  • Provides a tangible reward experience
  • Suitable for high-value or premium programs
  • Supports direct mail and gifting campaigns
  • Enhances perceived value of rewards

Compliance Considerations

  • Ensure accurate shipping information
  • Account for delivery timelines and logistics
  • Maintain records for fulfillment tracking and reporting

Common Program Types

  • Employee milestone rewards
  • Customer gifting programs
  • Direct mail campaigns
  • Premium incentive programs

Related Use Cases