Pular para o conteúdo principal
PUT
/
api
/
v1
/
auto-topup
/
settings
# Habilitar recarga por limite mínimo em $50, recarregar $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"
  }'

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

​
Atualizar Configurações de Recarga Automática

Configure ou atualize a recarga automática. Você pode habilitar a recarga baseada em limite mínimo (cobrança automática quando o saldo cai abaixo de threshold_amount), recarga mensal agendada (cobrança automática em um dia específico), ou ambas.

​
Endpoint

PUT /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
​
Content-Type
string
obrigatório
Deve ser definido como application/json

​
Corpo da requisição

​
is_enabled
boolean
Chave principal da recarga automática. Quando false, nem as recargas por limite mínimo nem as agendadas são disparadas.
​
threshold_amount
number
Limite mínimo para disparo, na moeda da conta. Faixa: 1–1000. Quando o saldo cai abaixo deste valor, uma recarga é enfileirada.
​
recharge_amount
number
Valor cobrado a cada vez que o limite mínimo é atingido. Faixa: 1–1000.
​
scheduled_payment_enabled
boolean
Habilita recargas mensais agendadas, em adição (ou em substituição) à recarga baseada em limite mínimo.
​
scheduled_amount
number
Valor cobrado no dia agendado. Faixa: 1–1000. Obrigatório quando scheduled_payment_enabled é true.
​
day_of_month
integer
Dia do mês para recargas agendadas. Faixa: 1–28 (evita situações específicas de fim de mês).
​
payment_method_id
string
ID do método de pagamento a ser cobrado. Deve ser um método já salvo na conta — veja Listar Métodos de Pagamento.

​
Exemplos

# Habilitar recarga por limite mínimo em $50, recarregar $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"
  }'

​
Resposta

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

​
Observações

  • O daily_limit é definido pelo seu plano e não pode ser modificado via API. Entre em contato com o suporte para solicitar um aumento.
  • Para desativar completamente a recarga automática, envie {"is_enabled": false} ou utilize Desativar Recarga Automática.
  • Após atualizar, execute Testar Recarga Automática para verificar se o método de pagamento funciona.