Integrar a venda

Toda venda que você quer comissionar precisa chegar ao Bonificou. Há três caminhos: a API, o link de rastreio e o cupom do parceiro.

1. Crie uma chave de API

Em Configurações › API keys: dê um Nome (por exemplo "Loja virtual"), escolha o Scope (conversions:write basta pra registrar vendas), informe o Código 2FA e clique em Criar API key. A chave completa aparece uma vez; guarde. A lista mostra o prefixo, o último uso e o botão Revogar.

2. Registre a venda

Seu sistema envia um POST /api/conversions com Authorization: Bearer bnk_live_…. Detalhes e exemplos em Integrar a venda pela API e na Referência da API. Use "is_test": true pra testar sem gerar pagamento.

3. Acompanhe em Vendas

Vendas lista as últimas 100 com parceiro, cliente, valor, status e data. Refund estorna a venda e reverte as comissões pendentes ou a pagar.

Links de rastreio

Cada parceiro tem um link https://t.bonificou.com.br/r/<sua-empresa>/<slug> que leva ao destino que você definiu e grava a atribuição. Em Links você vê, cria, pausa e arquiva.

Webhooks

Pra receber eventos (venda confirmada, pagamento feito) no seu sistema: Webhooks › Novo webhook, com a URL e os eventos. Cada entrega é um POST assinado com HMAC SHA-256 e reenviado com espera crescente se falhar. Veja Webhooks.

Regras de comissão (programa Clean)

Num programa Clean, quem define quanto cada venda paga é a regra de comissão: percentual único, percentual recorrente, valor fixo ou por faixa de volume. Em Regras de comissão › Nova rule. Vale pra vendas futuras, nunca retroativo. Em programa Network, o percentual vem da matriz do Construtor.

Se der errado

• 401 na API: a chave foi revogada ou o header está sem Bearer.
• A venda entrou sem parceiro: não veio o cookie do link nem o partner_id. Veja a atribuição na referência.
• Venda duplicada: envie sempre o mesmo identificador da venda; repetir não duplica.