Pular para o conteúdo principal
GET
/
api
/
v1
/
auto-topup
/
payment-methods
curl "https://app.talkover.ai/api/v1/auto-topup/payment-methods" \
  -H "Authorization: Bearer talq_your_environment_token_here"
{
  "success": true,
  "data": [
    {
      "id": "pm_uuid_1",
      "type": "card",
      "card": {
        "brand": "visa",
        "last4": "4242",
        "exp_month": 12,
        "exp_year": 2027
      },
      "is_default": true,
      "created_at": "2024-01-01T10:00:00Z"
    },
    {
      "id": "pm_uuid_2",
      "type": "card",
      "card": {
        "brand": "mastercard",
        "last4": "5555",
        "exp_month": 8,
        "exp_year": 2026
      },
      "is_default": false,
      "created_at": "2024-01-05T14:00:00Z"
    }
  ]
}

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.

Listar Métodos de Pagamento

Lista os métodos de pagamento salvos no seu ambiente que podem ser usados para recargas automáticas. Atualmente apenas métodos baseados em cartão são suportados.

Endpoint

GET /api/v1/auto-topup/payment-methods

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/payment-methods" \
  -H "Authorization: Bearer talq_your_environment_token_here"

Resposta

{
  "success": true,
  "data": [
    {
      "id": "pm_uuid_1",
      "type": "card",
      "card": {
        "brand": "visa",
        "last4": "4242",
        "exp_month": 12,
        "exp_year": 2027
      },
      "is_default": true,
      "created_at": "2024-01-01T10:00:00Z"
    },
    {
      "id": "pm_uuid_2",
      "type": "card",
      "card": {
        "brand": "mastercard",
        "last4": "5555",
        "exp_month": 8,
        "exp_year": 2026
      },
      "is_default": false,
      "created_at": "2024-01-05T14:00:00Z"
    }
  ]
}

Campos da Resposta

data[].id
string
obrigatório
ID do método de pagamento. Use este valor em payment_method_id ao configurar a recarga automática.
data[].type
string
obrigatório
Atualmente sempre card.
data[].card.brand
string
Bandeira do cartão (ex: visa, mastercard, amex).
data[].card.last4
string
Últimos 4 dígitos do cartão.
data[].card.exp_month
integer
Mês de expiração (1–12).
data[].card.exp_year
integer
Ano de expiração (AAAA).
data[].is_default
boolean
Indica se este é o método de pagamento padrão.

Observações

  • Novos métodos de pagamento podem ser adicionados pelo fluxo de checkout do dashboard — não há endpoint de API para adicionar cartões.
  • Os cartões são tokenizados — o número completo do cartão nunca é retornado pela API.