Account

Begin an idempotent credit top-up

Creates a payment-gated prepaid balance purchase. The durable attempt is keyed by request_id; promotional credit is added only after Stripe payment is verified. Purchased and promotional value expire after 12 months. Prepay, self-billed org owners only. Requires 'account' scope.

post/v1/account/topups

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/account/topups
  • Auth: HTTP bearer

Request body

request_idstring required
amount_centsinteger required

Response

Durable top-up attempt accepted

payment_attempt_idstring required
request_idstring required
status'pending' | 'action_required' | 'paid' | 'failed' required
amount_centsinteger required
bonus_centsinteger required
principal_credit_status'awaiting_payment' | 'updating' | 'available' | 'needs_attention' | 'not_applicable' required
bonus_credit_status'awaiting_payment' | 'updating' | 'available' | 'needs_attention' | 'not_applicable' required
credit_expires_after_months12 required

Changes

No recorded changes to this operation across all 1 revision of this API.