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

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