AbacatePay

API-key · Pix e cartão

Conexão por API-key (sem OAuth). Pix e cartão. Webhook por merchant com token.

Conectar

1. Gere sua API key no AbacatePay.
2. No painel → Gateways → AbacatePay, cole a key e Conectar. Após autenticar a chave, você recebe a URL completa de webhook (https://indicasaas.com/webhooks/abacatepay/SEU_TOKEN?webhookSecret=SEU_SECRET) + secret. A verificação da chave não comprova a identidade externa da conta.
3. Cadastre essa URL + secret no painel do AbacatePay e ative os eventos.

Passe o ref no checkout

Leia a referência com AFS.getRef() e envie o valor completo, sem interpretar ou encurtar, no externalId do checkout/assinatura ao criar a cobrança. Se retornar null, omita o campo de indicação. Quando a renovação não trouxer o campo, pode usar o vínculo de assinatura já atribuído. Não dependa de metadata arbitrária no webhook.

// Ao criar o checkout/cobrança no AbacatePay:
{
  "amount": 4900,
  "externalId": ref                 // AFS.getRef()
}

Atribuição pelo cupom, sem clique

Os descontos da AbacatePay podem ser criados pelo anunciante no IndicaSaaS. Para atribuir pelo cupom sem link, o checkout próprio do SaaS precisa validar o código, aplicar o desconto e confirmar a operação pelo backend. Cupom digitado somente na página hospedada da AbacatePay ainda não é identificado por este caminho.

POST /sdk/v1/coupon/attribution
Authorization: Bearer sk_...
Content-Type: application/json

{
  "programId": "SEU_PROGRAMA",
  "gatewayConnectionId": "SUA_CONEXAO_ABACATEPAY",
  "code": "JOAO10",
  "gatewayCustomerId": "cust_CLIENTE",
  "amountPaidCents": 9000,
  "couponApplied": true
}

Use a identidade do cliente no gateway e o total líquido em centavos calculados no servidor. A resposta traz ref, attributionSource: "merchant_checkout" e paymentRequired: true. Guarde o ref no pedido e envie-o inteiro no externalId da cobrança; em tentativas do mesmo pedido, reutilize o ref guardado. Nunca exponha a chave sk_ no navegador.

A rota não aplica desconto nem cria comissão. A comissão nasce quando chega o pagamento confirmado para a mesma conexão, cliente e valor. Seguem as regras de prazo, recorrência, autoindicação e estorno. Sem esta integração, divulgue também o link. Primeira cobrança, produtos e validade do desconto não são configurados no modo AbacatePay.

Eventos