> ## 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

> Listar métodos de pagamento salvos disponíveis para recarga automática

# 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

<ParamField header="Authorization" type="string" required>
  Token Bearer para autenticação. Formato: `Bearer talq_your_environment_token_here`
</ParamField>

## Exemplos

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/auto-topup/payment-methods" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```
</RequestExample>

## Resposta

<ResponseExample>
  ```json theme={null}
  {
    "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"
      }
    ]
  }
  ```
</ResponseExample>

### Campos da Resposta

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

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