Activity shown in the product preview: Workflow triggered, Task complete, 12 reactions, Credits redeemed.

Rewards API

Send rewards directly from your product

Launch global rewards inside your product without managing vendors, catalogs, or logistics. Plum's API handles fulfillment, compliance, and delivery so your team can focus on building.

POST /v1/orders
200 OK
cURLNodePythonRubyJava

Request

curl -X POST "https://api.xoxoday.com/v1/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "amazon_us",
    "denomination": 50,
    "currency": "USD"
  }'

Response

fulfilled · 0.4s
{
  "order_id": "ord_8f3c91",
  "status": "fulfilled",
  "voucher_url": "https://rewards.xoxoday.com/v/8f3c91"
}

Powering rewards for 5,000+ global brands

Adobe
Behr
Capgemini
Cosentino
Continental
Freshworks
H&M
HSBC
Kantar
Kennametal
Kohler
Michelin
Nielsen
Xero
Adobe
Behr
Capgemini
Cosentino
Continental
Freshworks
H&M
HSBC
Kantar
Kennametal
Kohler
Michelin
Nielsen
Xero
Adobe
Behr
Capgemini
Cosentino
Continental
Freshworks
H&M
HSBC
Kantar
Kennametal
Kohler
Michelin
Nielsen
Xero

Why Rewards API

Embed rewards in your product without building fulfillment

Skip the vendor contracts, catalog ops, and fulfillment engineering. Plum's REST API handles the entire rewards infrastructure while you own the experience.

Native in-product reward delivery

Deliver a seamless, fully branded redemption flow directly within your product. No redirects, embedded widgets, or third-party branding, just a consistent experience from end to end.

Enterprise-grade reliability

Built for scale with robust APIs, idempotency support to prevent duplicate fulfillment, real-time webhooks for status updates, and reporting capabilities designed for accurate reconciliation.

Global reward coverage

Access rewards across 150+ countries with multi-currency support through one API integration, reducing operational complexity and simplifying global reward distribution.

Features

Built for developers

Clean REST endpoints, webhooks, a sandbox, versioning, and an AI assistant. Everything you need to ship rewards into production.

RESTful APIs

Clean, predictable endpoints designed to scale with your product.

Flexible filters

Request and display rewards by country, currency, denomination, and category.

Developer-friendly

Integrate using cURL, Ruby, Python, or Java. Detailed docs and staging environments mean predictable builds.

Headless architecture

REST-based system that fits any frontend. Ship a prototype in a day, iterate without rebuilds.

Versioning

Maintain stability with version control. Upgrade on your timeline without breaking existing integrations.

Webhooks

Order status pushed to your endpoint in real time. No polling required.

Interactive documentation

Test live API calls and inspect responses directly within the docs for faster onboarding.

Dedicated sandbox

Test end-to-end workflows in a dedicated sandbox before going live. Same endpoints, same response shapes.

Ask AI

AI assistant trained on Plum's API docs. Ask in plain English, get answers while you build. Live at developers.xoxoday.com.

Catalog

One API. Six reward categories

Gift cards, merchandise, lounges, charity, mobile top-ups, and perks. All from one integration across 150+ countries.

Gift card catalog with brand options

Gift Cards API

10,000+ gift card SKUs across 150+ countries. Instant code delivery.

  • Country and brand filters
  • Wallet balance checks
  • Instant code delivery
  • Order status tracking
  • Finance-grade reconciliation reports

Pick the right API for your build

Four API products, one platform. Choose the integration that fits your workflow.

Rewards API

Send rewards directly from your product with full control over the user experience.

Reward Links API

Send automated, personalized reward links to your users through email, SMS, or your own channels.

Reward Points API

Send points users redeem across Plum's full 10M+ reward catalog.

Storefront Integration

Redirect users via SSO to Plum's hosted storefront. Browse and redeem under your branding.

bash
1curl -X POST https://api.xoxoday.com/v1/orders \
2 -H "Authorization: Bearer sk_live_..." \
3 -H "Idempotency-Key: order_abc123" \
4 -d '{
5 "product_id": "amazon_us",
6 "denomination": 50,
7 "currency": "USD",
8 "recipient": "user@acme.com"
9 }'
Common questions

Everything you would want to know

Bearer token authentication. Every request must include Authorization: Bearer <access-token> in the header. Treat tokens like passwords and never expose them in client-side code.