→Voltar ao dashboard
Logo GhostScale

Documentação

Integração, rastreamento e configuração

Webhook universal

API de Vendas

Endpoint universal para gateways enviarem vendas à GhostScale.

POST {BASE_URL}/api/webhooks/gateway

Autenticação:

bashGhostScale
Authorization: Bearer tb_live_...
(ou
bashGhostScale
X-TrackBase-Key
ou
bashGhostScale
?token=
). Gere o token em Integrações → Gateways.

Payload

jsonGhostScale
{
  "id": "TX123456",
  "status": "approved",
  "amount": 197.0,
  "currency": "BRL",
  "tracking": {
    "utm_source": "facebook",
    "utm_campaign": "CBO_KIT_01",
    "utm_content": "criativo-03",
    "fbclid": "IwAR..."
  }
}

Status aceitos

StatusEfeito
approvedVira Purchase (faturamento)
pendingConta como pendente
refunded / cancelledEstorna a venda
chargebackMarca chargeback

Teste rápido

Resposta:

jsonGhostScale
{received:true, orderId, status, event}
. Reenvios atualizam o pedido (idempotente por provider + external_id). Teste em /webhooks ou veja o guia completo em /docs/gateways.