Developer API · Closed beta

The gift card API for global rewards

Send digital gift cards from your own product with a simple REST API. Create reward programs, add recipients, and track every redemption — with virtual Visa cards and 3,000+ gift card brands that work in 60+ countries.

Request beta accessRead the docs ↓
⚡

REST, the way you expect

Predictable resource-oriented URLs, JSON responses, standard HTTP response codes, and bearer-token auth.

🌍

Global from day one

Every reward you send through the API works in 60+ countries with millions of vendor options.

🔔

Webhooks built in

Get notified when recipients claim their card, transact, or spend their full balance.

API reference

The API is in closed beta — endpoints may change as we incorporate feedback. Talk to us to get an API key.

Authentication

The Hoppier API uses API keys to authenticate requests. All requests must be made over HTTPS — calls over plain HTTP and requests without authentication will fail. Pass your key as a bearer token:

-H "Authorization: Bearer <HOPPIER_API_KEY>"

Test keys look like hk_test.abc123.… and production keys like hk_live.xyz789.…. Successful requests return 200; failures return 4xx or 5xx codes.

Programs

The program is at the heart of Hoppier. Most actions happen in the context of a program — it defines a real-world event (a meeting, conference, birthday, promotion) via a set of attributes.

Create a program

POST/v1/programs
{
  "id": "pr_Dl7RWP269Q",
  "name": "Thanks for attending!",
  "amount": 10000,
  "currency": "usd",
  "iconUrl": null,
  "colorHex": "#000000",
  "logoUrl": null,
  "status": "active",
  "startDate": 1632941953000,
  "endDate": null,
  "createdAt": 1633444947048,
  "updatedAt": 1633444947048
}

Retrieve a program

GET/v1/programs/:id

Update a program

POST/v1/programs/:id

List all programs

GET/v1/programs

Delete a program

DELETE/v1/programs/:id

Participants

A participant is the recipient of the virtual card. Participants are added to programs.

Add a participant

POST/v1/participants
{
  "id": "pcpt_123",
  "object": "participant",
  "email": "[email protected]",
  "firstName": "jill",
  "lastName": "smith",
  "program": "pr_123",
  "status": "pending"
}

List participants

GET/v1/participants

Remove a participant

DELETE/v1/participants/:id

Webhooks

Subscribe to events to keep your system in sync with what recipients do:

  • participant.claimed_program — a participant signed up through their invite link; their card was created.
  • participant.transacted_program — a participant used their card for a transaction.
  • participant.fully_spent_program — a participant's card balance reached $0.
{
  "participant": {
    "id": "pa_789",
    "email": "[email protected]",
    "full_name": "Jill Smith"
  },
  "program": {
    "id": "pr_123",
    "name": "Thanks for attending!",
    "amount_in_cents": 2000,
    "currency": "usd"
  },
  "card_balance_in_cents": 948,
  "transaction": {
    "created": 1585024162,
    "amount_in_cents": 1052,
    "merchant_name": "Food Place"
  }
}

What teams build with a gift card API

🔬

Research incentives

Pay survey panels and study participants instantly, in their own currency.

💜

Loyalty & referrals

Trigger rewards automatically when customers refer, review, or hit milestones.

🏆

Sales & CRM workflows

Send meeting incentives from your own tools — or use our Salesforce integration off the shelf.

🧑‍💼

HR automations

Birthdays, anniversaries, and onboarding gifts fired straight from your employee systems.

Looking for no-code options? See our ready-made integrations.

Gift card API FAQs

What is a gift card API?

A gift card API lets your software send digital gift cards programmatically instead of buying and emailing codes by hand. Your product calls the API to create a reward program, add recipients, and deliver cards automatically — at any volume, in any supported country.

Which brands and countries does the Hoppier gift card API support?

Every reward sent through the API draws on the same catalog as the Hoppier platform: 3,000+ gift card brands and virtual Visa cards across 60+ countries, localized to each recipient's country and currency.

How do recipients redeem gift cards sent via the API?

Recipients get an email or magic link, claim their virtual card in minutes, and spend it with approved vendors — no account or app required. Webhooks notify your system when a card is claimed, used, or fully spent.

What does the gift card API cost?

The API is in closed beta. Pricing follows the Hoppier platform model — you fund what you send and recover 100% of unspent balances. Talk to our team for beta access and volume pricing.

Can I get back money from unclaimed gift cards?

Yes — unlike traditional gift card distribution, unspent and unclaimed funds return to your Hoppier balance, and the API reports balances per card so you always know where the money is.

Want to build with the Hoppier API?

We're onboarding beta partners now. Tell us about your use case and we'll get you a key. Prefer something off the shelf? See our ready-made integrations, including Salesforce.

Request beta access