Skip to main content
You fund VIPs with points; your VIPs spend those points on experiences. The points you distribute are drawn from your organization’s prepaid points pool. Sandbox activity is always free and never touches the pool.

​
How the pool works

  • Every POST /v1/wallet/credit to one of your VIPs draws your pool down by the amount credited (LIVE only).
  • When the pool cannot cover a credit, the call returns 402 with error code INSUFFICIENT_ORG_POINTS - top the pool up and retry.
  • Your current balance and full grant / purchase / distribution history are on the Billing page of the developer portal.
An organization with no pool yet is ungated - distributions are free until your first top-up sets the pool up. Sandbox credits never draw the pool down.

​
Funding the pool

Enterprise grant

For a signed contract paid by invoice or wire, our team grants your pool an allotment directly - no card needed. Ask your Expys contact.

Self-serve purchase

Buy points any time from the portal Billing page. You are taken to Stripe to pay; your balance updates as soon as payment is confirmed.

​
Webhooks

Subscribe to keep your systems in step with the pool:
EventFires when
org.points.lowA distribution takes the pool to or below its low-water mark (once per crossing).
org.points.purchasedA self-serve top-up has credited your pool.
See Webhooks for delivery, signing, and retries.

​
Handling an empty pool

{
  "error": {
    "code": "INSUFFICIENT_ORG_POINTS",
    "message": "Insufficient organization points"
  }
}
Catch the 402, top the pool up (grant or purchase), and retry the credit. The credit is all-or-nothing: no points move when the pool is too low.