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"
  }
}

POST

api

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 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

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.

Get Started

Concepts

API Reference

Guides

Test Auto Topup

Test Auto Topup

Endpoint

Request headers

Examples

Response

Error responses

422 — Not Configured

402 — Payment Failed

Notes

​Test Auto Topup

​Endpoint

​Request headers

​Examples

​Response

​Error responses

​422 — Not Configured

​402 — Payment Failed

​Notes

Test Auto Topup

Endpoint

Request headers

Examples

Response

Error responses

422 — Not Configured

402 — Payment Failed

Notes