Wallet

Create an explicit Wallet Credits top-up by saved card or invoice.

post/v2/wallet/topup

Request

  • Base URL
    https://api.omtx.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Headers

Idempotency-Keystring required

Required for POST/PUT/DELETE. Reuse to safely retry.

Request body

amount_centsinteger required

USD-cent amount to add. Saved-card top-ups use the authenticated profile's wallet card-funding limit; invoice top-ups use $500 increments.

payment_mode'saved_card' | 'pay_invoice' required
invoice_buyerWalletInvoiceBuyer (unresolved $ref)
funding_operation_idstring nullable

The operation returned by wallet_topup_prepare; required for saved_card.

user_approval_confirmationstring required

Exact user approval text. For saved_card use 'I approve adding $<amount> Wallet Credits by saved card for funding operation <id>.'. For pay_invoice use 'I approve creating a $<amount> Wallet Credits invoice.'.

Response

Successful Response

unknown required

Changes

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