GiftPulse

Endpoints (6 live)

• GET /api/giftcard/catalog — Search Reloadly's gift card catalog (300+ brands, 14,000+ products/denominations across countries). Returns each product's id, brand, country, denomination range or fixed amounts, and sender fee/discount — everything needed to build a POST /api/giftcard/quote call. (0.01 USDC on Base)
• GET /api/topup/1 — Check the delivery status of an airtime top-up previously sent via POST /api/topup. Reconciles directly against Reloadly — never trust a "success" without this check for anything you plan to act on downstream. (0.005 USDC on Solana)
• GET /api/giftcard/1 — Check the status of a gift card order previously placed via POST /api/giftcard, and re-fetch its redemption code. Requires the client_request_id used at purchase (gates access — only the original buyer can re-fetch the code). (0.005 USDC on Base)
• GET /api/topup/lookup — Auto-detect the mobile carrier for a phone number and return its live top-up amount range/denominations and current discount, before quoting or sending airtime. Wraps Reloadly's operator auto-detect. Run this (or POST /api/topup/quote directly, which auto-detects internally) before POST /api/topup. (0.01 USDC on Solana)
• POST /api/topup — Send a REAL mobile airtime top-up via Reloadly, worldwide. This is an ACTION endpoint, not a data lookup: paying causes airtime to be credited to the destination phone number. Requires a quote_id from POST /api/topup/quote (free) and a client_request_id for idempotency (also passed to Reloadly as customIdentifier — a race can never double-send). (0.000001 USDC on Base)
• POST /api/giftcard — Order a REAL digital gift card via Reloadly, worldwide. This is an ACTION endpoint, not a data lookup: paying causes a real gift card to be issued, either emailed to recipient_email or returned as a redemption code in this response. Requires a quote_id from POST /api/giftcard/quote (free) and a client_request_id for idempotency (also passed to Reloadly as customIdentifier). (0.000001 USDC on Base)