Billing & Top-up

Manage account balances and payment methods

Top-up Account
Add funds to your agent account
Quick Top-up
Common top-up amounts for fast funding
HTTP 402 Payment Flow Demo
Test the payment required flow when accounts lack sufficient funds

When an agent attempts an operation without sufficient funds, the API returns HTTP 402 with payment details. This demo shows how it works:

Simulate Failed Transaction
Try to execute a $150 operation with only $89.25 in account
Expected Response:
HTTP/1.1 402 Payment Required
{
"error": "Payment Required",
"code": "INSUFFICIENT_FUNDS",
"message": "Insufficient funds...",
"requiredAmount": 150.00,
"currentBalance": 89.25,
"topUpUrl": "/billing/topup?..."
}
Payment History
Recent top-ups and charges
Account Top-up
Dec 4, 2024 at 2:20 PM
+$500.00
Completed
Account Top-up
Dec 3, 2024 at 4:30 PM
+$100.00
Completed
Auto Top-up
Dec 1, 2024 at 9:00 AM
+$250.00
Completed
Auto Top-up
Automatically add funds when balance falls below threshold
Enable Auto Top-up
Automatically fund accounts when they run low
Trigger threshold:$50.00
Top-up amount:$200.00
Status:Disabled