curl -X POST "https://app.talkover.ai/api/v1/auto-topup/test" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"message": "Test recharge completed successfully",
"data": {
"amount_charged": 100.00,
"currency": "USD",
"new_balance": 250.00,
"transaction_id": "txn_uuid_1"
}
}
Billing & Auto Topup
Test Auto Topup
Trigger a one-off recharge to verify auto topup configuration
POST
/
api
/
v1
/
auto-topup
/
test
curl -X POST "https://app.talkover.ai/api/v1/auto-topup/test" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"message": "Test recharge completed successfully",
"data": {
"amount_charged": 100.00,
"currency": "USD",
"new_balance": 250.00,
"transaction_id": "txn_uuid_1"
}
}
Test Auto Topup
Trigger a real one-off recharge using the configured payment method to verify auto topup is set up correctly. This bypasses the threshold check and immediately chargesrecharge_amount.
This is a real charge, not a simulation. The amount will be billed to the saved payment method and credited to your account balance.
Endpoint
POST /api/v1/auto-topup/test
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_hereExamples
curl -X POST "https://app.talkover.ai/api/v1/auto-topup/test" \
-H "Authorization: Bearer talq_your_environment_token_here"
Response
{
"success": true,
"message": "Test recharge completed successfully",
"data": {
"amount_charged": 100.00,
"currency": "USD",
"new_balance": 250.00,
"transaction_id": "txn_uuid_1"
}
}
Error responses
422 — Not Configured
{
"success": false,
"message": "Auto topup is not configured",
"code": "AUTO_TOPUP_NOT_CONFIGURED"
}
402 — Payment Failed
{
"success": false,
"message": "Payment method declined",
"code": "PAYMENT_FAILED",
"details": {
"decline_reason": "insufficient_funds"
}
}
Notes
- Use this endpoint sparingly — repeated test charges may be flagged by your payment provider.
- The test charge counts toward
daily_limitandrecharge_count_today.
Was this page helpful?