Conectar o Mercado Pago
Como trazer os pagamentos recebidos no Mercado Pago, com tarifas e estornos, para o Gestify Finance.
Conectando o Mercado Pago como gateway de pagamento, cada pagamento
recebido entra no Gestify Finance como receita, com a tarifa do Mercado
Pago e os estornos (inclusive parciais) e contestações. A receita vai
para o projeto certo pelo metadata.project, como nos outros gateways.
E o saldo da conta?
O gateway traz as vendas. O saldo e as retiradas da conta do Mercado Pago chegam pelo Open Finance, como qualquer conta bancária.
Passo a passo
Copie o Access Token de produção
No Mercado Pago, abra Suas
integrações, escolha a
aplicação da loja (ou crie uma) e vá em Credenciais de produção. Copie o
Access Token, que começa com APP_USR-.
Use o token de produção. O de teste e a Public Key não servem: com eles, o Gestify Finance não enxerga as vendas reais.
Conecte no Gestify Finance
Em Integrações → Integrações disponíveis, no card Mercado Pago, clique em Conectar. Dê um nome à loja, cole o Access Token e clique em Conectar Mercado Pago.
O token fica criptografado e nunca volta para o navegador. Cada conta do Mercado Pago só pode ser conectada uma vez.
Sincronize
Abra a conexão em Integrações → Conexões e clique em Sincronizar agora. A primeira sincronização traz os pagamentos dos últimos 12 meses (o limite da busca do Mercado Pago). Depois, o Gestify Finance busca sozinho só o que mudou.
Vincule a loja aos projetos
Abra o projeto e vá em Configurações → Integrações deste projeto. Em Gateways de pagamento, adicione a loja do Mercado Pago:
- Por identificador: a venda vai para o projeto quando o seu sistema manda
metadata.projectcom o slug do projeto ao criar o pagamento. - Loja inteira: todas as vendas da conta vão para o projeto.
Venda sem projeto fica no Corporativo, e dá para atribuir à mão em Cobranças.
Como cada pagamento entra
| No Mercado Pago | No Gestify Finance |
|---|---|
| Aprovado | Receita e tarifa, na data da aprovação |
| Estornado (total ou parte) | Estorno do valor devolvido, na data dele |
| Contestado (chargeback) | Estorno do valor inteiro |
| Em mediação | Continua como receita, marcado "Em disputa" |
| Pendente ou autorizado | Ainda não entra |
| Recusado ou cancelado | Não entra |
A tarifa considerada é a que o vendedor paga. Juros do parcelamento pagos pelo comprador não entram como despesa.
Problemas comuns
"O Mercado Pago recusou o token"
Confira se é o Access Token de produção (APP_USR-…) e se a aplicação não
foi apagada. Se você renovou as credenciais, o token antigo para de funcionar.
"Essa conta do Mercado Pago já está conectada"
Cada conta só entra uma vez. Para separar as vendas por produto, use o
metadata.project em vez de conectar a mesma conta de novo.