Full-text search across airtime, eSIMs, gift cards, and game top-ups. Returns up to 50 matching products with live prices.

Returns each product category (airtime, esim, giftcards, gaming, bills) with its item count.

Returns every product in one category (from list_categories).

Fetches one product by id (from search_catalog / get_category), including its current live price — always call this right before create_order to get the exact denomination.

Returns the calling partner account's current prepaid balance (ETB). Orders are paid from this balance.

Places a live order, debited from your prepaid balance. denomination MUST exactly match one of the product's denoms[].retailMinor from get_product — call get_product first to get a current price, since prices can change. recipient is required when the product's recipientType is phone_number or email (E.164 digits, no leading + for phone). Moves real money — only call this once you intend to complete the purchase.

Fetches the current status of one order by id — use this to re-check an order after create_order, or to recover from a timed-out call.

Returns up to 50 of your most recent orders, newest first.

Subscription seats (design tools, AI tools, streaming) priced on your reseller tier. Separate catalog and separate USD wallet from the store, but the same API key opens both.

Fetches one subscription product with its current tier price and stock — call this right before create_premium_order so you are quoting a live price.

The USD wallet premium orders are debited from. Check this before ordering — an order with insufficient balance is refused with 402.

Buys a subscription seat and debits your USD wallet. Confirm the product, the price and the recipient with the user before calling this — it is not reversible from here. An Idempotency-Key is sent automatically, so retrying an identical call is safe and will never double-charge.

Status of a premium order. Poll this after create_premium_order, or to recover from a timed-out call.

The credentials, invite or link for a fulfilled premium order. Unlike store orders, premium delivery is NOT inline on the order — you must call this once status is fulfilled.

Social-media services (followers, views, likes) with their rate per 1000 and min/max order size. There are ~7,500 services, so ALWAYS pass a query (e.g. "tiktok followers", "instagram likes") — an unfiltered list is enormous and mostly irrelevant. The min and max are enforced server-side; an order outside them is refused.

Buys a social-media service and debits your wallet. CONFIRM THE LINK WITH THE USER FIRST — delivery goes to whatever link is given and cannot be recalled once the supplier accepts it. Quantity must be within the service min/max.

Status and real delivery progress (start count, delivered so far, remaining) for an SMM order.

The endpoint we POST order events to, with its recent delivery health. Returns null if none is configured.

Registers an https endpoint we call on every terminal order state, so you can stop polling. RETURNS THE SIGNING SECRET EXACTLY ONCE — show it to the user and tell them to store it now; it can never be read back. Private, loopback and cloud-metadata addresses are refused.

Stops webhook delivery. Orders are unaffected; you fall back to polling get_order.

Posts a signed test event to the configured endpoint and reports what came back, so a partner can verify their signature check before relying on it.