Create a balance top-up (optionally with payment invoice in one call)
amount is the USD value to credit to your balance. You pay in
paymentCurrency — the response’s paymentAmount is the converted
amount due. Include paymentMethodId to also create the provider
invoice in the same round trip; otherwise pick from the returned
availablePaymentMethods and pay via a follow-up (the deposit expires
after ~60 minutes unpaid). Each deposit is capped by your tier’s
maxDepositUSD. The balance payment method cannot be used here.
Authorizations
API key (wg_live_…) created in the dashboard (Account → API Keys).
Shown once at creation; only a hash is stored server-side.
Body
USD value to credit to your balance. Capped by tier maxDepositUSD.
x >= 0.1500
Currency you will pay in.
USD, EUR, GBP, AUD, CAD, INR, BTC, LTC, USDC, USDT, XRP, XLM Optional — also create the provider invoice in this call.
Response
Deposit created. With paymentMethodId: includes payment (invoice). Without: includes availablePaymentMethods.