Como fazer o uso das adquirentes no painel

Perfil: Administrador da plataforma
​Área: Adquirentes

O que é uma adquirente dentro da plataforma

A adquirente é a instituição responsável por processar transações financeiras (cartão, PIX, boleto, etc.).
Na prática, ela é quem se comunica com as bandeiras, bancos emissores e sistemas de liquidação.

Dentro da plataforma, a adquirente funciona como o provedor de processamento de pagamentos.

Ela é responsável por:

• Autorizar transações

• Realizar transferências (saques)

• Criar contas de recebedores (split)

Como funciona a integração com uma adquirente

A integração ocorre via API, onde a plataforma envia e recebe informações financeiras em tempo real.

Fluxo simplificado de uma venda

1. O cliente final preenche o checkout

2. A plataforma envia os dados da transação para a adquirente

3. A adquirente valida:

   • Dados do pagamento

   • Antifraude (quando aplicável)

   • Saldo / limite do comprador

4. A adquirente retorna o status:

   • Aprovado

   • Recusado

   • Em análise

5. Se aprovado, a adquirente agenda a liquidação e os repasses

Como conectar uma adquirente à plataforma

De forma geral, a conexão exige credenciais fornecidas pela própria adquirente.

Etapas comuns

1. Criar conta na adquirente
   A empresa precisa estar cadastrada diretamente na adquirente.

2. Obter as credenciais de API
   Normalmente incluem:

   • API Key

   • Secret Key

   • Token de autenticação

   • Identificador da conta (quando aplicável)

3. Cadastrar as credenciais na plataforma
   No painel administrativo, a adquirente é configurada informando essas chaves de integração.

   

4. Configurar regras de uso

   • Métodos de pagamento habilitados

   • Parcelamento

   • Split (quando houver múltiplos recebedores)

   • Antifraude (se integrado)

Após isso, a adquirente já pode ser usada para processar vendas.

Como a plataforma “usa” a adquirente no dia a dia

Depois de conectada, a adquirente passa a ser utilizada automaticamente nas transações.

Ela é acionada quando:

• Uma venda é gerada no checkout

• Um reembolso é solicitado

• Um split é criado para dividir valores

• Uma conta de recebedor é criada ou atualizada

A plataforma apenas orquestra as requisições — o processamento financeiro real acontece na infraestrutura da adquirente.

Erros comuns na geração de vendas

Alguns problemas podem ocorrer durante a tentativa de pagamento:

1. Transação recusada

Pode acontecer por:

• Cartão sem limite

• Dados incorretos

• Bloqueio do banco emissor

• Suspeita de fraude

2. Erro de autenticação na adquirente

Ocorre quando:

• As chaves de API estão incorretas

• A credencial foi revogada

• O ambiente (produção/sandbox) está configurado errado

3. Método de pagamento não habilitado

A venda falha quando o meio de pagamento usado no checkout não está ativo na conta da adquirente.

Erros ao criar conta de split (subcontas)

Quando a plataforma trabalha com divisão de valores entre produtores, afiliados ou parceiros, é necessário criar contas de recebedores na adquirente.

Problemas comuns:

1. Dados cadastrais inválidos

• Documento incorreto

• Nome divergente do cadastro oficial

• Conta bancária inválida

A adquirente pode recusar a criação da conta.

2. Conta pendente de verificação

Algumas adquirentes exigem envio de documentos.
Enquanto a conta não é validada, o recebedor pode não conseguir sacar valores.

3. Falha de permissão na API

Se a credencial usada não tiver permissão para criar recebedores, o split não é configurado corretamente.

Erros relacionados a split de pagamentos

Mesmo com a conta criada, podem ocorrer falhas na divisão dos valores:

• Percentuais de split inválidos (ex: somam mais de 100%)

• Recebedor não encontrado na adquirente

• Recebedor bloqueado ou com cadastro incompleto

• Regra de repasse não compatível com o meio de pagamento

Nesses casos, a venda pode:

• Ser recusada

• Ser processada sem split

• Ficar com valor retido até correção

Boas práticas para evitar problemas

• Conferir se os métodos de pagamento estão ativos na conta da adquirente

• Validar corretamente os dados dos recebedores antes de criar splits

• Acompanhar logs de erro retornados pela adquirente

• Testar novos fluxos com valores baixos antes de liberar em escala

Resumo

A adquirente é quem efetivamente processa o pagamento.
A plataforma atua como intermediadora técnica, enviando e recebendo dados via API.

Quando ocorre um erro, na maioria dos casos ele está relacionado a:

• Configuração da integração

• Regras da própria adquirente

• Dados enviados na transação ou no cadastro de recebedores

Por isso, a integração correta e a validação dos dados são fundamentais para garantir que as vendas e os repasses funcionem sem interrupções.