Conectar a Pagar.me
Receba em reais com cartão parcelado e PIX pela sua conta Pagar.me, com assinaturas, order bump e upsell de 1 clique.
A Pagar.me processa cartão de crédito, cartão de débito e PIX em reais, para contas abertas no Brasil. Conectada ao Vipter, ela atende vendas avulsas, parcelamento no cartão, assinaturas, order bump e upsell de 1 clique.
Antes de começar
- Uma conta Pagar.me ativa. Para experimentar antes, o ambiente de teste da Pagar.me serve.
- Acesso à Dashboard da Pagar.me para ver as chaves e criar webhooks.
- Papel Admin ou Dono no projeto do Vipter.
- Espaço no seu plano para mais uma conexão ativa. A tela de provedores mostra quantas você já usa.
Passo 1: copiar a chave secreta na Pagar.me
- Entre na Dashboard da Pagar.me e confira em qual ambiente você está. As chaves de teste servem para experimentar, e as de produção para vender.
- Abra a página de chaves de acesso da Dashboard e copie a chave secreta do ambiente escolhido. A chave secreta de teste começa com
sk_test_.
Guarde a chave com cuidado
A chave secreta dá acesso às vendas da sua conta Pagar.me. Cole a chave só no Vipter. Se ela vazar, gere outra na Pagar.me e troque no Vipter pelo botão Trocar chaves.
Passo 2: criar a conexão no Vipter
- No painel do Vipter, abra PagamentosProvedoresPagar.me.
- Clique em Nova conexão. Se a loja ainda não tem nenhuma conta Pagar.me, o formulário já aparece aberto.
- Preencha os campos numerados:
| # | Campo | O que colar |
|---|---|---|
| 1 | Nome da conta | Um nome para reconhecer a conta, como "Pagar.me Loja". Ele aparece nos fluxos de pagamento. |
| 2 | País da conta | Brasil, já selecionado. A Pagar.me só atende contas abertas no Brasil. |
| 3 | Chave de API (Secret key) | A chave secreta que você copiou no passo 1. |
| 4 | Conexão de teste | Ligado, usa as chaves e os cartões de teste da Pagar.me (sk_test_). Desligue para cobrar de verdade com a chave de produção. |
- Clique em Salvar e obter a URL de webhook. O Vipter confere a chave com a Pagar.me antes de salvar. Se ela estiver errada, nada é gravado e o erro aparece no formulário.
O modo de teste vem ligado
O botão Conexão de teste começa ligado para que a primeira conexão não cobre ninguém por engano. Para vender, crie a conexão com ele desligado e a chave de produção.
Se a loja ainda não tem fluxo para cartão de crédito, cartão de débito ou PIX, o Vipter cria esses fluxos apontando para a nova conta. A loja já pode cobrar depois do passo 4.
Passo 3: cadastrar o webhook na Pagar.me
Pelo webhook, a Pagar.me avisa o Vipter do que acontece depois da compra: PIX pago, reembolsos, chargebacks e cobranças canceladas ou expiradas. A Pagar.me prova que o aviso é dela com um usuário e uma senha (autenticação HTTP Basic) que você mesmo escolhe. Sem esse par, a plataforma de pagamentos recusa os avisos da Pagar.me.
- Depois de salvar, o card da conexão mostra a URL do webhook. Copie o endereço.
- Ainda no card, invente um usuário e uma senha e preencha os dois campos:
| # | Campo | O que colar |
|---|---|---|
| 1 | Usuário do webhook (Basic Auth) | Um usuário qualquer, como vipter-webhook. Você vai repetir o mesmo valor na Pagar.me. Aparece como opcional, mas sem ele os avisos são recusados. |
| 2 | Senha do webhook (Basic Auth) | Uma senha longa, só para este webhook. Não use a senha da sua conta Pagar.me. |
- Clique em Salvar segredo.
- Na Dashboard da Pagar.me, abra ConfiguraçõesWebhooks e clique em Criar webhook.
- Cole a URL copiada no item 1.
- Selecione os eventos de pedido e de cobrança. O Vipter usa estes:
- pedido:
order.paid,order.payment_failedeorder.canceled; - cobrança:
charge.paid,charge.pending,charge.payment_failed,charge.refunded,charge.partial_canceled,charge.canceled,charge.chargedback,charge.expired,charge.underpaidecharge.overpaid.
- pedido:
- Ative a autenticação do webhook e informe o mesmo usuário e a mesma senha do item 2.
- Confirme com a senha da sua conta Pagar.me e salve.
Um webhook por ambiente
O webhook criado no ambiente de teste da Pagar.me só avisa das vendas de teste. Quando criar a conexão de produção, cadastre outro webhook no ambiente de produção com a URL dessa nova conexão.
Passo 4: testar a conexão
- No card da conexão, clique em Testar. O Vipter consulta a Pagar.me com a chave salva.
- Faça uma compra de teste no checkout de uma oferta. Com o modo de teste ligado, use o cartão
4000 0000 0000 0010com qualquer data de validade futura. Na Pagar.me de teste, esse cartão é sempre aprovado.
Deu certo se
Aparece a mensagem Conexão OK., o card mostra Segredo de verificação configurado. e a compra de teste entra em VendasTransações como paga.
Problemas comuns
-
Seu plano permite N conector(es) ativo(s). Faça upgrade para adicionar mais.
O plano chegou ao limite de conexões ativas. Desative uma conexão que não usa mais ou mude de plano em Plano Vipter.
-
A Pagar.me recusou a chave
A chave está incompleta, é de outra conta ou é de teste com o modo de teste desligado (ou o contrário). Copie de novo a chave secreta, não a pública (
pk_), e confira o botão Conexão de teste. -
Sem o segredo de verificação a plataforma recusa os eventos deste provedor. Cadastre a URL acima no provedor, copie o segredo e salve aqui.
O usuário e a senha do webhook não foram salvos no Vipter. Refaça os itens 2 e 3 do passo 3.
-
O PIX foi pago, mas o pedido segue pendente
O aviso da Pagar.me não chegou ou foi recusado. Confira se o webhook existe no mesmo ambiente da conexão (teste ou produção), se a URL é a do card desta conexão e se o usuário e a senha na Pagar.me são iguais aos salvos no Vipter. Se trocar os valores, salve de novo nos dois lados.
O que fazer a seguir
- Defina quantas parcelas a loja oferece e com quais juros em parcelamento.
- Revise os fluxos de pagamento para decidir qual conta cobra cada pagamento e qual serve de reserva.