API-first integration

Connect every channel to one loyalty engine. Stable REST endpoints, machine credentials, webhooks, and idempotent writes — built for engineers who integrate once and scale forever.

What you can do over the API

Members, wallets, ledger movements, tiers, campaigns, rewards, and operational events — all exposed as tenant-scoped HTTP resources.

  • Members & profiles

    Create and resolve members by your own identifiers. Attach metadata your channels and CRM already use.

  • Wallets & balances

    Credit, debit, transfer, and query balances with explicit wallet types and unit definitions you configure per tenant.

  • Tiers & campaigns

    Evaluate tier status, enroll members in campaigns, and trigger earn rules from transactions or behavioural events.

  • Rewards & fulfilment

    Catalogue rewards, reserve inventory, and confirm redemption — with audit trails on every state change.

Integration patterns

Authenticate with API clients, scope every call to your tenant, and rely on idempotency keys for safe retries.

# Earn points after a qualifying event (idempotent)
POST /v1/members/{member_id}/wallets/{wallet_id}/credit
Authorization: Bearer <access_token>
Idempotency-Key: billing-cycle-2026-07-abc123

{
  "amount": 150,
  "reason": "monthly_plan_payment",
  "external_ref": "inv_9f2a..."
}
  • API clients

    Machine credentials issued per integration — not shared user passwords. Rotated and audited from the admin dashboard.

  • Webhooks

    Subscribe to earn, redeem, tier change, and custom events. Push loyalty state to your CDP, CRM, or data warehouse in real time.

  • Idempotency

    Every value mutation accepts an idempotency key. Retries never double-credit or double-spend — essential at telecom scale.