Developer API · 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 3,000+ gift card brands that work in 60+ countries.

Request beta access Read the docs →

add-participant.js

const res = await fetch(
  "https://app.hoppier.com/api/v1/participants",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${HOPPIER_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      program: "prg_Z8q3NnW2xK",
      email: "[email protected]",
      firstName: "Maya",
      lastName: "Lopez",
      sendEmailAsUsersAreAdded: true,
    }),
  }
);

⚡

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 beta - endpoints may change as we incorporate feedback. The full reference lives at docs.hoppier.com. 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"
  }
}

~$50M

in rewards sent

60+

countries, local currency

3,000+

gift card brands

1,200+

companies sending

Prefer an AI agent to the API? Use the Hoppier MCP

Hoppier ships an MCP server, so Claude, ChatGPT, and other AI agents can create reward programs, add participants, and send top-ups by chat instead of code. Same catalog, same spend controls, no integration work. It's the fastest way into agentic payments with spend controls. Weighing providers? See our ranking of the best gift card APIs and our honest Tremendous comparison.

Set up the Hoppier MCP →

What teams build with a gift card API

🔬

Research incentives

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

Survey incentives guide →

💜

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.

Salesforce integration →

🧑‍💼

HR automations

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

Birthday automation guide →

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

What can trigger a send

Any event your systems can emit can start a reward. These are the triggers we wire most - as custom rules on your account today, self-serve when the public API ships. The demand is not hypothetical: two thirds of the value sent on Hoppier last year went to use cases with an external trigger like these, and almost all of it was still set up by hand.

Sales & CRM

Deal and relationship rewards, synced from your CRM.

Deal closedDeal stage changeRenewal signedDemo completedNPS responseReferral logged

HRIS & people

Milestone rewards driven by your employee directory.

New hire onboardedBirthday reachedWork anniversaryPromotionCertification completedPeer recognition

Surveys & research

Response and participation rewards, paid on completion.

Survey completedScore threshold metPartial follow-upPanel invitation accepted

Marketing & webinars

Attendance and engagement incentives for campaigns.

Attendance threshold metRegistrationNo-show re-engagementPoll or Q&A engagementLead score reached

ERP & procurement

Keep Hoppier balance activity reconciled with your ERP or procurement platform.

Expense report approvedPurchase order issuedInvoice paidAudit note posted back

Who builds on the Hoppier API

Beta partners tend to be one of four teams. Tell us which one you are and we can point you at the shortest path.

Resellers & gifting platforms

You already sell gifting or payouts and want more coverage: 3,000+ gift card brands and 60+ countries behind your own catalog, with unspent value recovered instead of written off.

Products adding a reward step

Your product creates the moment - a completed shift, a signed greeting card, a sales contest - and a reward is the natural next step. Trigger the send from your app; we handle choice, delivery, and tracking.

Enterprises with internal payout workflows

Recognition, commissions, lunch programs at scale. The busiest company on our platform created 2,282 programs by hand last year - internal workflows are exactly what the API exists to replace.

Research & panel operations

Study payouts on completion webhooks: international, anonymous-friendly, same-day, with unclaimed incentives returning to the research budget. The workflow is detailed in our survey incentives guide.

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 Hoppier gift card catalog: 3,000+ brands across 60+ countries, localized to each recipient's country and currency. Prepaid Visa cards are a platform feature and are not available through the API.

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?

There is no platform fee and no per-send fee on the API: access is part of the free plan, and you fund face value - send a $25 card and you fund $25. Standard card-processing fees apply if you load your balance by credit card, and on Plus plans whatever the recipient doesn't spend returns to your balance. The API is in beta - talk to our team for 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