Integrar a venda pela API

Toda venda que a sua empresa quer comissionar entra no Bonificou por um POST /api/conversions.

Autenticação

Crie uma chave em Configurações › Chaves de API (pede o código 2FA; a chave aparece uma vez). Envie em todo request:

Authorization: Bearer bnk_live_...

Registrar uma venda

curl -X POST https://app.bonificou.com.br/api/conversions \
  -H "Authorization: Bearer $BONIFICOU_API_KEY" \
  -H "Content-Type: application/json" \
  -d @venda.json

A atribuição pode vir do link de rastreamento (o cookie b_ref que o link do parceiro grava) ou ser direta, informando o parceiro. Os campos do corpo, os códigos de resposta e os exemplos completos estão na Referência da API.

Idempotência e estorno

Envie um identificador único da venda: repetir o mesmo request não duplica a comissão. Vendas estornadas dentro do prazo do programa não pagam.

Venda de teste

Envie "is_test": true no corpo: a venda roda a cascata inteira, aparece marcada como teste, e não gera pagamento, rank nem aviso. Use enquanto integra.