Skip to main content
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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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 charges recharge_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

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

​
Examples

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_limit and recharge_count_today.