Pular para o conteúdo principal
GET
/
api
/
v1
/
auto-topup
/
history
curl "https://app.talkover.ai/api/v1/auto-topup/history?per_page=10" \
  -H "Authorization: Bearer talq_your_environment_token_here"
{
  "success": true,
  "data": [
    {
      "id": "topup-uuid-1",
      "amount": 100.00,
      "currency": "USD",
      "trigger": "threshold",
      "status": "succeeded",
      "balance_before": 42.00,
      "balance_after": 142.00,
      "payment_method_id": "pm_uuid_1",
      "transaction_id": "txn_uuid_1",
      "created_at": "2024-01-10T14:30:00Z"
    },
    {
      "id": "topup-uuid-2",
      "amount": 200.00,
      "currency": "USD",
      "trigger": "scheduled",
      "status": "failed",
      "failure_reason": "card_declined",
      "payment_method_id": "pm_uuid_1",
      "created_at": "2024-01-01T08:00:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total": 23,
    "last_page": 3
  }
}

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.

Obter Histórico de Recarga Automática

Lista os eventos recentes de recarga automática do seu ambiente, incluindo valor, status e o disparador (limite mínimo ou agendado).

Endpoint

GET /api/v1/auto-topup/history

Parâmetros de Consulta

per_page
integer
Itens por página. Faixa: 1100. Padrão: 25.
page
integer
Número da página. Padrão: 1.

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/history?per_page=10" \
  -H "Authorization: Bearer talq_your_environment_token_here"

Resposta

{
  "success": true,
  "data": [
    {
      "id": "topup-uuid-1",
      "amount": 100.00,
      "currency": "USD",
      "trigger": "threshold",
      "status": "succeeded",
      "balance_before": 42.00,
      "balance_after": 142.00,
      "payment_method_id": "pm_uuid_1",
      "transaction_id": "txn_uuid_1",
      "created_at": "2024-01-10T14:30:00Z"
    },
    {
      "id": "topup-uuid-2",
      "amount": 200.00,
      "currency": "USD",
      "trigger": "scheduled",
      "status": "failed",
      "failure_reason": "card_declined",
      "payment_method_id": "pm_uuid_1",
      "created_at": "2024-01-01T08:00:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total": 23,
    "last_page": 3
  }
}

Valores de Disparador

  • threshold — disparado porque o saldo caiu abaixo de threshold_amount
  • scheduled — disparado em um dia configurado do mês
  • test — recarga de teste manual via Testar Recarga Automática

Valores de Status

  • pending — pagamento em processamento
  • succeeded — pagamento capturado, saldo creditado
  • failed — pagamento recusado ou com erro