Verify

Sellers and gateways call one endpoint and get an answer in under 50 ms.

A seller runs a check before it serves. One call says whether the pass is good and what the spending limit has left. TollRelay never charges and never moves the money.

POST https://api.trlay.dev/verify
{ "identity_jwt": "…", "seller_id": "api.exa.ai", "endpoint": "/search", "amount_usd": "0.020", "rail": "x402", "settlement_ref": "eip155:8453:0x…" }

The answer says whether the pass is valid, which organisation and agent it belongs to, whether the organisation is verified, the spending limit remaining, and a receipt id to write into your history.

Offline

Check the pass against the public keys at https://api.trlay.dev/.well-known/jwks.json. No call is needed, so the check does not depend on TollRelay being up.

Online

Call /verify to check revocation, reputation and the spending limit remaining. For a paid call, send the payment reference in settlement_ref; TollRelay records it and does not move the money.

A seller that charges by 402

Declare the tollrelay-identity extension in the 402 payment requirements. The agent sends X-Trlay-Identity with its payment. After the payment is made, call /verify with the reference from the payment response, as network:transaction, in settlement_ref. TollRelay never pays and never takes payment.

Pricing

A seller pays per check.

• First 10,000 checks a month: free.
• To 1 million: $0.001 per check.
• To 10 million: $0.0005 per check.
• Beyond: $0.0002 per check.