Pular para o conteúdo principal
GET
/
api
/
v1
/
auto-topup
/
settings
curl "https://app.talkover.ai/api/v1/auto-topup/settings" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "data": {
    "is_enabled": true,
    "threshold_amount": 50.00,
    "recharge_amount": 100.00,
    "scheduled_payment_enabled": false,
    "scheduled_amount": null,
    "day_of_month": null,
    "payment_method_id": "pm_uuid_1",
    "daily_limit": 500.00,
    "recharge_count_today": 0,
    "last_recharge_at": "2024-01-10T14:30:00Z",
    "currency": "USD"
  }
}

​
Obter Configurações de Recarga Automática

Recupera a configuração atual de recarga automática (Auto Topup) do seu ambiente. A recarga automática repõe automaticamente o saldo da conta quando ele cai abaixo de um limite mínimo, ou em um dia agendado a cada mês.

​
Endpoint

GET /api/v1/auto-topup/settings

​
Cabeçalhos da requisição

​
Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

​
Exemplos

curl "https://app.talkover.ai/api/v1/auto-topup/settings" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Resposta

{
  "success": true,
  "data": {
    "is_enabled": true,
    "threshold_amount": 50.00,
    "recharge_amount": 100.00,
    "scheduled_payment_enabled": false,
    "scheduled_amount": null,
    "day_of_month": null,
    "payment_method_id": "pm_uuid_1",
    "daily_limit": 500.00,
    "recharge_count_today": 0,
    "last_recharge_at": "2024-01-10T14:30:00Z",
    "currency": "USD"
  }
}

​
Campos da Resposta

​
data.is_enabled
boolean
Indica se a recarga automática está atualmente ativa.
​
data.threshold_amount
number
Limite mínimo de saldo (na moeda da conta) abaixo do qual uma recarga é disparada.
​
data.recharge_amount
number
Valor cobrado a cada vez que o limite mínimo é atingido.
​
data.scheduled_payment_enabled
boolean
Indica se as recargas mensais agendadas estão ativas (independente do limite mínimo).
​
data.scheduled_amount
number
Valor cobrado no dia agendado. Obrigatório quando scheduled_payment_enabled é true.
​
data.day_of_month
integer
Dia do mês (1–28) para recargas agendadas.
​
data.payment_method_id
string
ID do método de pagamento salvo usado para as cobranças.
​
data.daily_limit
number
Valor total máximo que pode ser cobrado em um único dia em todos os eventos de recarga automática.
​
data.recharge_count_today
integer
Número de recargas já executadas hoje.
​
data.last_recharge_at
string
Timestamp ISO 8601 da recarga mais recente.