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.