# Enable threshold-based topup at $50, recharge $100
curl -X PUT "https://app.talkover.ai/api/v1/auto-topup/settings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"is_enabled": true,
"threshold_amount": 50,
"recharge_amount": 100,
"payment_method_id": "pm_uuid_1"
}'
# Enable monthly scheduled topup of $200 on the 1st
curl -X PUT "https://app.talkover.ai/api/v1/auto-topup/settings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"is_enabled": true,
"scheduled_payment_enabled": true,
"scheduled_amount": 200,
"day_of_month": 1,
"payment_method_id": "pm_uuid_1"
}'
{
"success": true,
"data": {
"is_enabled": true,
"threshold_amount": 50.00,
"recharge_amount": 100.00,
"scheduled_payment_enabled": false,
"payment_method_id": "pm_uuid_1",
"daily_limit": 500.00,
"updated_at": "2024-01-15T13:00:00Z"
}
}
Billing & Auto Topup
Update Auto Topup Settings
Configure threshold-based or scheduled auto topup
PUT
/
api
/
v1
/
auto-topup
/
settings
# Enable threshold-based topup at $50, recharge $100
curl -X PUT "https://app.talkover.ai/api/v1/auto-topup/settings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"is_enabled": true,
"threshold_amount": 50,
"recharge_amount": 100,
"payment_method_id": "pm_uuid_1"
}'
# Enable monthly scheduled topup of $200 on the 1st
curl -X PUT "https://app.talkover.ai/api/v1/auto-topup/settings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"is_enabled": true,
"scheduled_payment_enabled": true,
"scheduled_amount": 200,
"day_of_month": 1,
"payment_method_id": "pm_uuid_1"
}'
{
"success": true,
"data": {
"is_enabled": true,
"threshold_amount": 50.00,
"recharge_amount": 100.00,
"scheduled_payment_enabled": false,
"payment_method_id": "pm_uuid_1",
"daily_limit": 500.00,
"updated_at": "2024-01-15T13:00:00Z"
}
}
Update Auto Topup Settings
Configure or update auto topup. You can enable threshold-based recharging (auto-charge when balance drops belowthreshold_amount), monthly scheduled recharging (auto-charge on a specific day), or both.
Endpoint
PUT /api/v1/auto-topup/settings
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
boolean
Master switch for auto topup. When
false, neither threshold nor scheduled recharges fire.number
Trigger threshold in account currency. Range:
1–1000. When the balance drops below this, a recharge is queued.number
Amount charged each time the threshold is hit. Range:
1–1000.boolean
Enables monthly scheduled recharges in addition to (or instead of) threshold-based.
number
Amount charged on the scheduled day. Range:
1–1000. Required when scheduled_payment_enabled is true.integer
Day of month for scheduled recharges. Range:
1–28 (avoids month-end edge cases).string
ID of the payment method to charge. Must be a method already saved on the account — see List Payment Methods.
Examples
# Enable threshold-based topup at $50, recharge $100
curl -X PUT "https://app.talkover.ai/api/v1/auto-topup/settings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"is_enabled": true,
"threshold_amount": 50,
"recharge_amount": 100,
"payment_method_id": "pm_uuid_1"
}'
# Enable monthly scheduled topup of $200 on the 1st
curl -X PUT "https://app.talkover.ai/api/v1/auto-topup/settings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"is_enabled": true,
"scheduled_payment_enabled": true,
"scheduled_amount": 200,
"day_of_month": 1,
"payment_method_id": "pm_uuid_1"
}'
Response
{
"success": true,
"data": {
"is_enabled": true,
"threshold_amount": 50.00,
"recharge_amount": 100.00,
"scheduled_payment_enabled": false,
"payment_method_id": "pm_uuid_1",
"daily_limit": 500.00,
"updated_at": "2024-01-15T13:00:00Z"
}
}
Notes
- The
daily_limitis set by your plan and cannot be modified via API. Contact support to request an increase. - To turn off auto topup entirely, send
{"is_enabled": false}or use Disable Auto Topup. - After updating, run Test Auto Topup to verify the payment method works.
Was this page helpful?