Conectar a AbacatePay
Como trazer as cobranças, taxas, estornos e saques da sua loja AbacatePay para o Gestify Finance.
Conectando a loja da AbacatePay, cada cobrança paga entra no Gestify Finance como receita, com a taxa da AbacatePay, os estornos e as disputas. Os saques para o banco também entram e são casados com o crédito na sua conta bancária, para a venda não contar duas vezes.
Passo a passo
Crie uma chave de API de produção
No painel da AbacatePay, crie uma chave de API de produção (começa com
abc_prod_). Permissão de leitura basta: o Gestify Finance nunca cria nem
altera cobranças.
Conecte no Gestify Finance
Em Integrações → Integrações disponíveis, no card AbacatePay, clique em Conectar. Dê um nome à loja, cole a chave e clique em Conectar loja.
A chave fica criptografada e nunca volta para o navegador. Tem mais de uma loja? Conecte cada uma com a sua chave.
Sincronize
Abra a conexão em Integrações → Conexões e clique em Sincronizar agora. Depois, o Gestify Finance sincroniza sozinho, a cada 6 horas.
Vincule a loja aos projetos
Abra o projeto e vá em Configurações → Integrações deste projeto. Em Gateways de pagamento, adicione a loja:
- Pelo identificador em
metadata.project: a cobrança vai para o projeto quando o seu sistema manda o slug do projeto emmetadata.projectao criar a cobrança. Use quando a mesma loja vende vários produtos. - Loja exclusiva deste projeto: todas as cobranças da loja vão para o projeto.
Cobrança sem projeto fica no Corporativo, e dá para atribuir à mão em Cobranças.
Como cada cobrança entra
| Na AbacatePay | No Gestify Finance |
|---|---|
| Paga | Receita e taxa, na data do pagamento |
| Estornada | Estorno do valor inteiro, na data do estorno |
| Em disputa | Continua como receita, marcada "Em disputa" |
| Pendente/expirada | Não entra |
| Saque concluído | Transferência do saldo da loja para o banco, e a taxa do saque como despesa |
Problemas comuns
"A AbacatePay recusou a chave"
Confira se é a chave de produção (abc_prod_…) e se ela tem permissão de
leitura das cobranças. A chave de desenvolvimento não enxerga as vendas reais.
Uma venda apareceu no Corporativo
A cobrança chegou sem metadata.project, ou com um slug que não está
vinculado a nenhum projeto. Atribua à mão em Cobranças ou ajuste o
identificador em Configurações → Integrações deste projeto.