v1

latestOpenAPI 3.1.02026-08-04134182237.9 KB
Billing

Upload Money

[ADMIN ONLY] Manually credit a user account.

SEC-004: This endpoint is restricted to admins only. Normal users credit their balance via the Stripe checkout flow, which is verified by webhook.

post/api/billing/upload

Request body

amount_usdnumber required

Amount to upload in USD (max $10,000)

payment_method_idstring nullable

Stripe payment method ID

target_user_idstring nullable

User ID to credit (admin only). Defaults to admin's own account if omitted.

idempotency_keystring nullable

Caller-supplied idempotency key to prevent double-credits on retry

Response

Successful Response

successboolean
messagestring nullable
new_balancenumber nullable