Integrações

1. Abra Configurações → Notificações → Webhooks e copie a chave usada pela Shopify para assinar os webhooks.
2. Selecione Shopify no BirdTrack, insira a chave e copie a URL gerada.
3. Na Shopify, crie dois webhooks em JSON para a mesma URL, Criação de pedido (orders/create) e Pagamento de pedido (orders/paid). Para refletir cancelamentos e estornos, assine também orders/cancelled e orders/updated.
4. Faça um pedido de teste em BRL. As UTMs são lidas de landing_site e dos atributos do pedido em note_attributes quando esses campos chegam.

1. Selecione o gateway e gere a URL exclusiva desta oferta.
2. Se criar cobranças por API, use a URL em postback_url e envie os parâmetros de campanha no objeto tracking. Em um checkout pronto, use a URL na configuração de postback da oferta, quando disponível.
3. Teste a emissão e a aprovação de um Pix. O BirdTrack lê transaction_id, status e o amount em centavos.

Crie uma credencial de API e envie o JSON abaixo do servidor. Reutilize order_id e a mesma credencial ao aprovar a venda. O status aceito é pending ou approved.

curl -X POST 'https://birdtrack.duckdns.org/api/v1/orders' \
 -H 'Authorization: Bearer SUA_CREDENCIAL' \
 -H 'Content-Type: application/json' \
 -d '{
  "order_id": "pedido-123",
  "status": "pending",
  "amount_cents": 92023,
  "currency": "BRL",
  "customer": {"name": "Cliente", "email": "cliente@example.com", "phone": "+5511999990000"},
  "payment_method": "pix",
  "products": [{"name": "Oferta principal", "quantity": 1}],
  "utm": {"utm_source": "meta", "utm_campaign": "lancamento"}
}'