Criar pedido de pagamento

Homologação

https://hml.api.pedagioeletronico.com.br/am-gateway-api/v1

POST

/pedidos

Pedidos

Cria um pedido de pagamento para uma ou mais transações.

Regras:

Apenas transações com status PENDENTE podem ser incluídas em um pedido

O pedido expira em 30 minutos se não for pago (configurável)

Suporta idempotência via header x-chave-idempotencia

O parceiro deve ter saldo suficiente na carteira Arrecada+

Idempotência: Enviar a mesma x-chave-idempotencia em duas requisições retorna o mesmo pedido sem duplicar.

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 Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201

application/json

Pedido criado com sucesso

Body

🟠400

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://hml.api.pedagioeletronico.com.br/am-gateway-api/v1/pedidos' \
--header 'x-chave-idempotencia: pedido-lw-20260401-001' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transacoes": [
        {
            "transacaoId": "trx_001_20260401"
        },
        {
            "transacaoId": "trx_002_20260401"
        }
    ]
}'

Response Example

201 - Sucesso

{
    "success": true,
    "data": {
        "pedidoId": "ped_lw_001",
        "status": "CRIADO",
        "valorTotal": 28.5,
        "expiraEm": "2026-04-01T10:30:00Z",
        "transacoes": [
            {
                "transacaoId": "trx_001_20260401",
                "dataPassagem": "2026-04-01T08:15:00Z",
                "valorTotal": 9.5
            },
            {
                "transacaoId": "trx_002_20260401",
                "dataPassagem": "2026-04-01T14:25:30Z",
                "valorTotal": 19
            }
        ]
    },
    "meta": {
        "timestamp": "2026-04-01T10:00:00Z",
        "requestId": "req_ped_001"
    }
}

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

Página anterior

Listar transações disponíveis

Próxima página

Consultar pedido