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.idcomo 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
/
v2
/
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âmetrok 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 |
Parâmetros de consulta
Chave de conexão obtida no painel do Metrito ao criar uma conexão "Personalizado"
Exemplo:
"abc123def456"
Corpo
application/json
Resposta
Webhook aceito e enfileirado para processamento