Funding your wallet

Rewards draw from a prepaid wallet, so keeping it funded is the one piece of housekeeping your integration needs.

Start a top-up

curl -X POST https://paybilt-rewards-api.fly.dev/v1/topups \
  -H "Authorization: Bearer $REWARDLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amountCents": 100000}'

{
  "topup": { "id": "tp_...", "amountCents": 100000, "status": "PENDING" },
  "checkoutUrl": "https://checkout.stripe.com/c/pay/...",
  "paymentsMode": "stripe"
}

Send whoever manages billing to checkoutUrl to pay. Minimum top-up is $10, maximum $100,000 per transaction.

Know when it lands

Two options:

• Subscribe to the wallet.credited webhook — it fires the moment checkout succeeds and the wallet is credited.
• Poll GET /v1/topups until the top-up's status is SUCCEEDED.

Keeping a float

A simple pattern for production: check GET /v1/wallet before each send (or on a schedule), and alert your team with a pre-filled checkoutUrl when availableCents drops below your threshold. Wallet top-ups can't be fully automated — a human completes the Stripe checkout — so build the nudge, not the payment.