Webhook — Nova transação capturada

Webhook

POST

transacaoCapturada

Enviado quando uma nova passagem de pedágio é capturada para uma placa monitorada (modo Filtrado) ou qualquer placa (modo Total).

Headers enviados pela Movvia:

Content-Type: application/json
x-parceiro-assinatura: sha256={hmac_signature}

Validação HMAC-SHA256:
O parceiro deve validar o header x-parceiro-assinatura usando a chaveSecreta cadastrada no webhook.

expected = HMAC-SHA256(chaveSecreta, requestBody)
valid = (x-parceiro-assinatura == "sha256=" + expected)

Resposta esperada: HTTP 2XX para confirmar recebimento. Caso contrário, a Movvia faz retry.

Requisição

Authorization

Basic Auth

Envie suas requisições HTTP com um cabeçalho

Authorization

que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password

Exemplo:

Authorization: Basic *****************

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200

Webhook recebido com sucesso

Esta resposta não possui corpo.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://your-api-server.com' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "evento": "TRANSACAO_CAPTURADA",
    "timestamp": "2026-04-01T14:30:00Z",
    "dados": {
        "placa": "ABC1D23",
        "transacao": {
            "transacaoId": "trx_001_20260401",
            "dataPassagem": "2026-04-01T14:25:30Z",
            "valorTotal": 9.5,
            "valorPedagio": 8.5,
            "valorTaxas": 1,
            "concessionaria": "ECOVIA",
            "praca": "Praça São José dos Pinhais",
            "categoria": "CATEGORIA_1",
            "status": "PENDENTE",
            "dataVencimento": "2026-04-30T23:59:59Z"
        }
    }
}'

Modificado em 2026-04-02 17:47:55

Página anterior

Consultar pedido

Próxima página

Webhook — Pedido pago