Purchase Toll Voucher

Creates a toll voucher purchase and allows tracking of its processing status.

The request is processed asynchronously, and a GUID is returned for tracking.

Endpoints

  • POST /valePedagio/comprar/{enterpriseId} → Create purchase

  • GET /valePedagio/comprar/{enterpriseId}/{guid} → Retrieve purchase status

Headers

The JWT token must be sent in the header:

Authorization: Bearer {token}

POST – Purchase Toll Voucher

The client submits the toll voucher data with the purchase details.
The API starts asynchronous processing and immediately returns a GUID for tracking.

GET – Purchase Status

Allows checking the status of a previously submitted purchase using the GUID.

HTTP Status Codes

  • 200 or 201:

    • POST: Indicates the purchase was received and accepted for processing

    • GET: Indicates the request was successfully processed

  • 400: Validation error (invalid request data or incorrect GUID)

  • 401: Unauthorized (missing or invalid JWT token)

  • 500: Internal server error