> ## Documentation Index
> Fetch the complete documentation index at: https://support.wepayments.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Tratamento de Exceções e Falhas

Apesar de todos os esforços, exceções de pagamento ocorrem. Este guia explica como a WEpayments trata pagamentos falhos, novas tentativas, reprocessamento, problemas de qualificação de dados, atrasos em depósitos e outros casos excepcionais.

## Reprocessamento de Pagamentos

Quando um pagamento falha, pode ser necessário **reprocessá-lo** – ou seja, criar uma nova tentativa de pagamento com informações corrigidas ou confirmadas.

### Quando o reprocessamento é necessário?

| **Cenário**                      | **Ação necessária**                           |
| :------------------------------- | :-------------------------------------------- |
| Dados do beneficiário incorretos | Corrija os dados e crie um novo Payout        |
| Saldo insuficiente               | Adicione fundos e reprocesse                  |
| Rejeição bancária (temporária)   | Aguarde e tente novamente, ou contate o banco |
| Bloqueio de conformidade         | Envie documentos e aguarde aprovação          |

> 💡 O reprocessamento não é automático. Você deve iniciar um novo pagamento após resolver o problema.

## Outras informações importantes sobre o Payout

### Limites de pagamento

| **Meio de pagamento** | **Limite típico**                      |
| :-------------------- | :------------------------------------- |
| PIX                   | Até R\$ 15.000 (dependente do banco)   |
| TED                   | Sem limite máximo (sujeito a contrato) |

### Horários de corte para processamento

| **Meio** | **Corte**                                              | **Processamento**                |
| :------- | :----------------------------------------------------- | :------------------------------- |
| PIX      | Nenhum – 24/7                                          | Instantâneo                      |
| TED      | Horário bancário (geralmente 16h, horário de Brasília) | Próximo dia útil se após o corte |

### Correspondência de nome do beneficiário

Os bancos brasileiros aplicam regras rígidas de correspondência de nomes. Até um pequeno erro de digitação (ex.: "João" vs "JOAO") pode causar rejeição. Use o Data Collect para que os beneficiários informem seus nomes exatamente como cadastrado no banco.

## Meu beneficiário confirmou que os dados bancários estão corretos, mas não passaram pela qualificação de dados. Qual pode ser o motivo?

Essa é uma situação comum. Mesmo quando um beneficiário *acredita* que seus dados estão corretos, a validação pode falhar por diversas razões:

| **Possível causa**               | **Explicação**                                                                          | **Solução**                                                                   |
| :------------------------------- | :-------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------- |
| **Nome diferente**               | Os registros bancários mostram um nome diferente (ex.: "José Silva" vs "Jose da Silva") | Peça ao beneficiário que confirme exatamente como aparece no extrato bancário |
| **Tipo de conta errado**         | O beneficiário selecionou "Corrente" mas a conta é "Poupança"                           | Corrija o tipo de conta                                                       |
| **Dígito da agência ausente**    | Alguns bancos exigem um dígito de agência que o beneficiário omitiu                     | Verifique a documentação do banco                                             |
| **Chave PIX não registrada**     | O beneficiário afirma que a chave existe, mas ela não está no registro do Banco Central | Peça ao beneficiário que verifique a chave PIX no aplicativo do banco         |
| **Conta encerrada ou bloqueada** | A conta existe, mas não está ativa                                                      | O beneficiário deve entrar em contato com o banco                             |
| **Alteração recente de conta**   | Os dados da conta foram alterados recentemente; o registro ainda não foi atualizado     | Aguarde 24 a 48 horas ou use os dados bancários em vez do PIX                 |

### Abordagem recomendada

1. Solicite ao beneficiário um **extrato bancário** (ou captura de tela do aplicativo do banco)
2. Compare os dados com o que foi inserido
3. Use o **Data Collect** para que o beneficiário insira suas próprias informações
4. Se o PIX falhar, tente TED com os dados bancários completos (ou vice-versa)

> 💡 O Data Collect reduz significativamente as falhas de qualificação porque os beneficiários inserem suas próprias informações diretamente, eliminando erros de transcrição.

## Criei um depósito, mas o saldo da minha carteira Payout ainda não foi atualizado

Após criar um depósito (adicionar fundos à sua carteira Payout), o saldo pode não ser atualizado imediatamente. Veja os possíveis motivos:

| **Possível causa**                   | **O que fazer**                                                                   |
| :----------------------------------- | :-------------------------------------------------------------------------------- |
| **Depósito ainda em processamento**  | Aguarde alguns minutos e atualize o Dashboard                                     |
| **Atraso na transferência bancária** | Transferências bancárias podem levar 1 a 2 dias úteis para compensar              |
| **Dados de depósito incorretos**     | Verifique a conta de origem e o valor. Contate o suporte se necessário            |
| **Depósito em revisão**              | Verificações antifraude ou de conformidade podem reter o depósito temporariamente |
| **Final de semana ou feriado**       | Transferências TED só são processadas em dias úteis                               |

### Status dos depósitos e seus significados

| **Status**    | **Significado**                                    | **Saldo atualizado?**   |
| :------------ | :------------------------------------------------- | :---------------------- |
| **Created**   | Depósito iniciado, aguardando confirmação bancária | Não                     |
| **Pending**   | Transferência bancária em andamento                | Não                     |
| **Confirmed** | Recursos recebidos e creditados no seu saldo       | Sim                     |
| **Failed**    | Depósito falhou                                    | Não – contate o suporte |

## Casos excepcionais comuns e soluções

| **Caso excepcional**                                   | **Solução**                                                             |
| :----------------------------------------------------- | :---------------------------------------------------------------------- |
| **Chave PIX válida, mas pagamento falha**              | Tente TED com dados bancários completos                                 |
| **Beneficiário trocou de banco**                       | Solicite nova chave PIX ou dados bancários                              |
| **Valor acima do limite diário do PIX**                | Divida em múltiplos pagamentos PIX ou use TED                           |
| **Pagamento parado em "Processing"**                   | Aguarde 1 hora (PIX) ou 1 dia útil (TED); em seguida, contate o suporte |
| **Reembolso solicitado, mas cliente pagou via boleto** | Não é automático – use o produto Payout ou contate o suporte            |
| **Chargeback recebido após 90 dias**                   | Não é possível para PIX; cartão de crédito permite até 180 dias         |
| **Pagamento duplicado enviado**                        | Solicite o reembolso ao beneficiário (não é automático)                 |

## Boas práticas para minimizar exceções

| **Prática**                                               | **Por que ajuda**                           |
| :-------------------------------------------------------- | :------------------------------------------ |
| **Usar o Data Collect**                                   | Elimina erros de inserção manual            |
| **Validar chaves PIX antes do pagamento**                 | Detecta chaves inválidas antecipadamente    |
| **Manter saldo suficiente**                               | Previne falhas por saldo insuficiente       |
| **Manter os dados dos beneficiários atualizados**         | Evita falhas por informações desatualizadas |
| **Monitorar os status das transações**                    | Identifica problemas imediatamente          |
| **Responder às solicitações de conformidade rapidamente** | Reduz atrasos na revisão                    |
