O Pagar.me V5 é uma solução de pagamentos que pode ser integrada à Uappi para processar transações realizadas na loja.
A integração permite utilizar Pix, boleto e cartão de crédito, além de recursos como captura, estorno, atualização de transações, armazenamento de cartões e split de pagamentos.
Neste conteúdo, você aprenderá como obter as credenciais do Pagar.me, configurar o gateway na Uappi e vinculá-lo aos meios de pagamento da loja.
O que está disponível na integração?
Com o Pagar.me V5, é possível utilizar:
Meios de pagamento
● Pix;
● boleto;
● cartão de crédito.
Operações
● consulta;
● captura;
● estorno;
● callback para atualização das transações.
Split de pagamento
● Pix;
● boleto;
● cartão de crédito;
● captura;
● estorno.
A integração também permite criar e remover cartões salvos e criar ou editar clientes associados aos pagamentos.
Antes de começar
Para realizar a configuração, você precisa:
● possuir uma conta ativa no Pagar.me;
● ter acesso à dashboard do Pagar.me;
● ter acesso às configurações de pagamento da Uappi;
● possuir a chave pública e a chave secreta da conta que será utilizada.
Importante: as credenciais da integração são informações sensíveis. Mantenha principalmente a chave secreta em local seguro e não a compartilhe.
1. Acesse o Pagar.me V5 na Uappi
No painel da Uappi, acesse:
Apps > Pagamento > Gateways de pagamento
Localize o Pagar.me V5 e clique na opção para editar o gateway.
2. Obtenha as credenciais no Pagar.me
Para realizar a integração, você precisará da chave pública e da chave secreta da conta Pagar.me.
Acesse a dashboard do Pagar.me e faça login.
Em seguida:
1. acesse a conta que será integrada à Uappi;
2. confirme se está utilizando o ambiente desejado, de teste ou produção; 3. acesse Configurações;
4. localize a área de Chaves;
5. copie a chave pública;
6. gere ou copie a chave secreta.
Cadastre as credenciais na Uappi
Volte à configuração do Pagar.me V5 na Uappi e preencha:
● Chave pública: informe a chave pública obtida no Pagar.me;
● Chave secreta: informe a chave secreta da conta Pagar.me.
3. Configure o ambiente de homologação
A opção Homologação permite utilizar a integração em modo de testes na Uappi. Para realizar testes:
1. ative Homologação;
2. utilize as chaves de teste do Pagar.me;
3. valide os cenários de Pix, boleto e cartão de crédito.
Quando a integração estiver pronta para produção:
1. desative a homologação;
2. substitua as credenciais pelas chaves de produção;
3. confirme se o Pagar.me V5 está vinculado aos meios de pagamento que serão disponibilizados na loja.
Importante: no Pagar.me V5, o ambiente também é identificado pelo tipo de chave utilizada. Por isso, utilize as chaves de teste durante a homologação e as chaves de produção quando a integração estiver disponível para vendas.
4. Configure o antifraude
Na configuração do Pagar.me V5, também é possível definir o comportamento do antifraude.
Os campos disponíveis são:
● Ativo/Inativo: habilita ou desabilita o antifraude, quando essa opção estiver disponível;
● Tipo de antifraude: define o serviço de antifraude utilizado;
● SLA do antifraude: define o tempo máximo de espera, em segundos, pelo retorno da análise.
Essas configurações são utilizadas principalmente quando a loja trabalha com um serviço de antifraude terceiro integrado ao Pagar.me.
5. Configure a captura e a atualização dos pedidos
Na configuração do gateway, defina também como a captura das transações e a atualização dos pedidos serão realizadas.
Captura automática
Define se a transação será capturada automaticamente após a autorização.
Quando essa opção não é utilizada, a transação permanece autorizada e depende de uma captura posterior.
Alterar status do pedido quando a transação for capturada
Quando habilitada, permite atualizar o status do pedido na Uappi após a captura da transação.
Alterar status do pedido quando a transação for cancelada
Quando habilitada, permite atualizar o status do pedido após o cancelamento da transação.
6. Configure as informações do pagamento
Na configuração do Pagar.me V5, você também encontrará campos relacionados às informações apresentadas no pagamento.
Descrição na fatura do cartão
Define a identificação da compra que poderá aparecer na fatura do cartão do cliente.
O campo permite uma descrição de até 13 caracteres. Por isso, utilize uma identificação curta e de fácil reconhecimento pelo cliente.
Prefira uma descrição curta e que facilite a identificação da compra pelo cliente.
Caso o conteúdo ultrapasse o limite permitido pela conta, a descrição enviada poderá ser cortada.
Observação do pagamento
Permite definir uma mensagem de observação relacionada ao pagamento.
7. Configure o split de pagamento
O split de pagamento permite dividir o valor de uma transação entre diferentes recebedores.
Na configuração do Pagar.me V5, localize a opção:
Split de pagamento (dividir pagamento por subpedidos e seus armazéns)
Ative o recurso quando a operação da loja precisar dividir os valores entre subpedidos e armazéns.
Localize o ID do recebedor
Para localizar o identificador utilizado no split:
1. acesse a dashboard do Pagar.me;
2. acesse Recebedores;
3. localize o recebedor desejado;
4. copie o respectivo ID;
5. informe o identificador no campo ID do recebedor para o split de pagamento, na Uappi.
Defina as responsabilidades do seller
Na configuração do split, também é possível determinar as responsabilidades do seller. Seller responsável pelo chargeback
Define se o seller será responsável pelo prejuízo em caso de contestação da compra. Quando a opção estiver desativada, a responsabilidade fica com o marketplace.
Seller responsável pelas taxas
Define se o seller será responsável pelas taxas cobradas nas transações.
Cadastre os IDs dos sellers
Caso a operação utilize mais de um recebedor, cadastre o ID correspondente a cada seller na configuração de Split de pagamento da Uappi.
Para cada seller:
1. selecione o seller;
2. selecione o gateway Pagar.me V5;
3. informe o ID do recebedor correspondente no Pagar.me;
4. salve a configuração.
8. Vincule o Pagar.me V5 aos meios de pagamento
Depois de configurar o gateway, é necessário vinculá-lo aos meios de pagamento utilizados pela loja.
Acesse a configuração do meio de pagamento desejado e selecione Pagar.me V5 como conector.
Cartão de crédito
Na configuração do cartão de crédito, selecione Pagar.me V5 e configure os campos disponíveis para a operação da loja.
Entre eles:
● Label: nome do meio de pagamento apresentado no checkout;
● Instruções: informações adicionais apresentadas ao cliente;
● Gerenciador de cartão: permite armazenar cartões para compras futuras; ● Exigir CVV: solicita o código de segurança do cartão;
● Antecipar seleção de pagamento: antecipa a seleção quando o cliente possui cartão salvo;
● Antifraude apenas na primeira transação: permite enviar a análise de antifraude apenas na primeira transação do cliente.
Depois, salve a configuração.
Boleto
Acesse a configuração de Boleto bancário e selecione Pagar.me V5 como conector.
Configure os campos apresentados, como Label, Descrição e Instruções, de acordo com a operação da loja.
Depois, salve.
Pix
Acesse a configuração de Pix e selecione Pagar.me V5 como conector. Configure os campos apresentados, como Label, Descrição e Instruções. Depois, salve.
9. IP Allowlist
O Pagar.me disponibiliza o recurso IP Allowlist, utilizado para restringir as origens autorizadas a realizar requisições para a conta.
Essa configuração é opcional e só precisa ser realizada quando o recurso estiver ativo na conta Pagar.me.
A lista pode utilizar:
● IPs ou intervalos de IPs, para as requisições realizadas pela integração; ● domínios, para o fluxo de criação do token do cartão no checkout.
Quando o IP Allowlist estiver ativo, será necessário liberar:
1. os IPs dos servidores da WAPI responsáveis pelas requisições da integração; 2. o domínio da loja utilizado na tokenização do cartão.
Importante: não cadastre https://wapi.webart.com.br como domínio no IP Allowlist. Para obter os IPs atuais da WAPI que devem ser liberados, entre em contato com o suporte da Uappi.
Uma configuração incorreta do IP Allowlist pode impedir o processamento das transações. Para saber mais, consulte a documentação IP Allowlist — Pagar.me.
10. Configure o webhook
O webhook permite que as atualizações das transações realizadas no Pagar.me sejam comunicadas à integração e, posteriormente, à Uappi.
Na dashboard do Pagar.me:
1. acesse Configurações > Webhooks;
2. clique em Criar webhook;
3. informe a URL da WAPI;
4. selecione os eventos necessários;
5. salve a configuração.
Utilize a URL:
https://wapi.webart.com.br/api/v1/run/app/pagarme-v5-api/callback
Selecione pelo menos os eventos de pedido utilizados pela integração:
● order.paid;
● order.canceled;
● order.payment_failed.
Quando disponíveis e necessários para a operação, também podem ser selecionados eventos relacionados à captura e ao estorno, como:
● charge.captured;
● charge.refunded.
Configurações complementares
Dependendo da operação da loja, também podem ser utilizadas outras configurações relacionadas aos meios de pagamento.
Retentativa de pagamento
Na configuração de retentativa de Cartão de crédito transparente, é possível definir a preferência de gateway por bandeira.
Pagamentos múltiplos
Caso a loja permita utilizar mais de um meio de pagamento na mesma compra, configure também Pagamentos múltiplos.
Nessa área, podem ser definidas informações como:
● Label;
● exibição no checkout;
● desconto à vista;
● quantidade máxima de cartões.
Essas configurações complementam o fluxo de pagamento e não substituem a configuração do Pagar.me V5.
Pontos importantes
Antes de disponibilizar o Pagar.me V5 em produção, confira alguns pontos da integração. Utilize as credenciais do ambiente correto
Para realizar testes, utilize as chaves de teste com a homologação ativa.
Antes de disponibilizar o gateway aos clientes, utilize as chaves de produção e mantenha a homologação desativada.
Confira o limite da descrição da fatura
A descrição da fatura permite até 13 caracteres. Prefira descrições curtas para evitar que o conteúdo seja cortado.
Prefira descrições curtas para evitar que o conteúdo seja cortado.
Verifique o IP Allowlist
Se o recurso estiver ativo e os IPs da WAPI ou o domínio necessário para o checkout não estiverem liberados, as transações podem não ser processadas.
Perguntas frequentes
Quais meios de pagamento podem utilizar o Pagar.me V5? A integração possui suporte a Pix, boleto e cartão de crédito.
A integração permite estorno?
Sim. A integração contempla consulta, captura e estorno de transações.
O Pagar.me V5 possui suporte a split de pagamento?
Sim. O split pode ser utilizado com Pix, boleto e cartão de crédito e também contempla operações de captura e estorno.
Para utilizar o recurso, é necessário habilitar o split no conector e configurar os IDs dos recebedores utilizados pela operação.
Posso testar a integração antes de disponibilizá-la na loja?
Sim. Ative a homologação na Uappi e utilize as chaves de teste do Pagar.me para validar os cenários de pagamento.
É possível armazenar cartões dos clientes?
Sim. Para isso, habilite o Gerenciador de cartão na configuração do meio de pagamento de cartão de crédito.
O IP Allowlist é obrigatório?
Não. A configuração só é necessária quando o recurso estiver ativo na conta Pagar.me.
Nesse caso, os IPs necessários para a comunicação com a WAPI e o domínio utilizado no checkout devem estar devidamente liberados.
O que devo conferir antes de utilizar o Pagar.me V5 em produção? Antes de disponibilizar o gateway aos clientes, verifique:
● se estão sendo utilizadas as credenciais de produção;
● se a homologação está desativada;
● se o Pagar.me V5 está vinculado aos meios de pagamento desejados; ● se a captura está configurada corretamente;
● se o antifraude está configurado de acordo com a operação;
● se o IP Allowlist está configurado corretamente, quando utilizado;
● se o webhook está configurado;
● se os recebedores e sellers estão configurados corretamente, quando houver split.
Atualizado em 03/09/2026
Deixe um comentário