Create a wallet top-up link
Creates a hosted payment page (Stripe Checkout or a Razorpay Payment Link) that adds amount_minor to the API token’s organization wallet once the customer pays. Open checkout_url in a browser; nothing is charged until the customer pays there, and the wallet is credited only after the payment succeeds (poll GET /billing/wallet to confirm). The gateway and currency follow the organization’s billing profile. Billing applies its minimums and refuses a frozen or closed wallet, an organization that is not billed, or (first top-up) an amount below the first top-up minimum: 422 topup_rejected with Billing’s message. An organization without a wallet gets 404 wallet_not_found; no wallet is created. The token’s principal also needs permission to manage the organization’s billing; a restricted or suspended organization can still top up. Requires scope: billing.topup.
Authentication
IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.
Headers
Retry key for this top-up, scoped to the organization’s wallet. A repeated key returns the payment link (and amount) it first created. Without a key, every call creates a new payment link.
Query parameters
The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.
Request
Amount to add, an integer in the wallet currency’s minor unit (paise for INR, cents for USD). Billing applies its minimum.
Response headers
Always no-store.
Response
Payment link created. Repeating the same Idempotency-Key returns the same link.
ISO 4217 currency of the amount, such as INR or USD.
