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.
Ao enviar pagamentos no Brasil, é importante entender as informações necessárias para identificar a conta bancária de um beneficiário.
Dependendo do método de pagamento, as transações podem ser processadas utilizando uma Chave PIX ou dados bancários tradicionais. Embora o PIX simplifique o processo de pagamento, as informações de conta bancária ainda são amplamente utilizadas para transferências eletrônicas e validações operacionais.
Uma conta bancária brasileira é normalmente identificada pelas seguintes informações:
| Campo | Descrição | Exemplo | Obrigatório |
|---|
| Código do banco | Número de 3 dígitos que identifica o banco (ex.: 341 = Itaú) | 341 | Sim |
| Agência | Geralmente 4 dígitos que identificam a agência. Se houver 5 dígitos, apenas os 4 primeiros são obrigatórios | 4567 | Sim |
| Dígito da agência | Opcional. Nem todos os bancos utilizam | 9 (de 45679) | Não |
| Número da conta | Identifica a conta. Pode ter até 15 caracteres | 38219 | Sim |
| Dígito da conta | Sempre o último número da conta. Deve ser fornecido separadamente | 7 (de 38219-7) | Sim |
| Tipo de conta | S para Poupança ou C para Corrente | C | Sim |
💡 No nosso Dashboard, na opção Bancos, você tem acesso à lista completa de bancos com seus respectivos códigos.
Chave PIX vs. Dados Bancários
Antes do lançamento do PIX no Brasil, todas as transferências bancárias exigiam dados bancários (código do banco, agência, número da conta e dígito). Esses dados funcionavam como o “endereço” para onde os fundos deveriam ser enviados.
Com o PIX, foi introduzida a Chave PIX como uma forma simplificada dos dados bancários.
| Recurso | Dados Bancários | Chave PIX |
|---|
| Formato | Múltiplos campos (banco, agência, conta, etc.) | Campo único |
| Exemplos | Banco 341, Agência 4567, Conta 38219-7 | CPF, CNPJ, e-mail, telefone ou chave aleatória |
| Uso | Pagamentos eletrônicos (TED, DOC) | Pagamentos instantâneos (PIX) |
| Disponibilidade | Encontrado no aplicativo do banco do beneficiário ou no cartão físico | Cadastrado pelo titular da conta |
💡 Uma Chave PIX está sempre vinculada a uma conta bancária. Você também pode realizar um pagamento PIX utilizando os dados bancários tradicionais, se preferir.
Entendendo CPF e CNPJ
No Brasil, os números de identificação fiscal são obrigatórios para a maioria das operações financeiras.
CPF (Cadastro de Pessoas Físicas)
| Aspecto | Detalhes |
|---|
| Para quem | Pessoas físicas (brasileiros e estrangeiros residentes que pagam impostos) |
| Formato | 11 dígitos: 9 dígitos base + 2 dígitos verificadores |
| Exemplo | 231.002.999-00 |
| Validação | Erros de digitação resultam em um número inválido (os dígitos verificadores são derivados matematicamente) |
CNPJ (Cadastro Nacional da Pessoa Jurídica)
| Aspecto | Detalhes |
|---|
| Para quem | Empresas constituídas no Brasil, incluindo empresas estrangeiras que investem no país |
| Formato | 14 dígitos: 12 dígitos base + 2 dígitos verificadores |
| Exemplo | XX.YAX.532/0001-09 |
| Validação | Erros de digitação resultam em um número inválido |
💡 Tanto o CPF quanto o CNPJ podem ser utilizados como Chaves PIX.
Os beneficiários geralmente podem encontrar suas informações bancárias por meio de:
- Seu aplicativo bancário
- Portais de internet banking
- Extratos bancários
- Documentação bancária fornecida pela instituição financeira
Boas Práticas
Antes de enviar um pagamento, sempre verifique se:
- O nome do beneficiário está correto
- O CPF ou CNPJ corresponde ao titular da conta
- O código do banco é válido
- Os números de conta e agência foram inseridos corretamente
- O tipo de conta correto foi selecionado
Informações precisas do beneficiário ajudam a reduzir falhas de pagamento e melhoram a eficiência do processamento.
