curl --request POST \
  --url https://api.metrito.com/v2/tracking/generic \
  --header 'Content-Type: application/json' \
  --data '
{
  "transaction": {
    "id": "order_0987654321",
    "status": "pending",
    "commission_currency": "BRL",
    "commission_value": 9990,
    "created_at": "2024-06-15T10:00:00Z",
    "updated_at": "2024-06-15T10:00:00Z"
  }
}
'

{
  "success": true
}

Pedidos

Webhook de Pedido

Webhook genérico para receber eventos de pedido/transação de qualquer plataforma de checkout, ERP ou sistema customizado.

O parâmetro k na query string identifica e autentica a requisição. Nenhum header Authorization é necessário.

O Metrito irá:

Fazer upsert do registro da transação usando transaction.id como chave única
Detectar o tipo de evento automaticamente pelo campo status
Disparar conversão de Compra para a Meta Conversion API quando status = "approved"
Associar a transação a um lead rastreado via UTM, e-mail ou telefone

POST

tracking

generic

curl --request POST \
  --url https://api.metrito.com/v2/tracking/generic \
  --header 'Content-Type: application/json' \
  --data '
{
  "transaction": {
    "id": "order_0987654321",
    "status": "pending",
    "commission_currency": "BRL",
    "commission_value": 9990,
    "created_at": "2024-06-15T10:00:00Z",
    "updated_at": "2024-06-15T10:00:00Z"
  }
}
'

{
  "success": true
}

Autenticação

O parâmetro k na query string identifica e autentica a requisição. Onde encontrar sua chave: No painel do Metrito, acesse Conexões → Adicionar Conexão → Personalizado. A URL completa do webhook (incluindo seu k) é exibida após a criação.

Valores Monetários

Todos os valores monetários devem ser enviados como inteiros em centavos.

Campo	Exemplo (BRL)	Valor Correto
`transaction.value`	R$ 199,80	`19980`
`transaction.commission_value`	R$ 29,97	`2997`

Status de Transação

Valor	Dispara Compra Meta?
`pending`	Não
`approved`	Sim
`failed`	Não
`refunded`	Não
`chargeback`	Não

Query Parameters

string

required

Chave de conexão obtida no painel do Metrito ao criar uma conexão "Personalizado"

Example:

"abc123def456"

Body

application/json

transaction

object

required

Show child attributes

utm

object

Show child attributes

Response

Webhook aceito e enfileirado para processamento

success

boolean

Visão Geral

Plataforma

API de Dados

API de Rastreamento

Webhook de Pedido

Autenticação

Valores Monetários

Status de Transação

Query Parameters

Body

Response

​Autenticação

​Valores Monetários

​Status de Transação

Query Parameters

Body

Response

Autenticação

Valores Monetários

Status de Transação