Open a hosted session

Open a hosted session

Use this when you want to reuse one paid observation. A hosted session is a /route product. It is not the merchant Session Client, which funds a seller channel.

Open costs $0.005 USDC. The window is 20 hops or 10 minutes on the bound snapshot from open. Then open again. Hops do not run a new 7-URL probe and do not call facilitator /verify or /settle. Completed misses are free. Seller payment stays with your buyer.

Open

curl -sS -D - https://402signal.com/route \
  -H 'Content-Type: application/json' \
  --data '{"url":"https://seller.example/x402","session":"open","require_route_binding":true}'

HTTP 402 supplies the $0.005 requirements. Authorize that fee once and submit the identical request. require_route_binding on open can emit a v4 receipt. wrapExactAuthorize is the default MIT guard on that open. Hops do not use the wrap.

Hop

Send session=hop and the session_id from open. A raw session id, or any other value, in session is miss_reason=invalid_session_shape: HTTP 200, no probe, no routing fee.

curl -sS -D - https://402signal.com/route \
  -H 'Content-Type: application/json' \
  --data '{"session":"hop","session_id":"0000000000000000000000000000000000000000000000000000000000000000","url":"https://seller.example/x402"}'

The session_id in the example is a schema-valid placeholder. Replace it with the real 64-hex id from open. The example url is optional on hop and pins the bound snapshot when present.

A hop that restores the bound winner reports route_outcome.code=session_hop and next_action=none. Optional scheme, amount_atomic and payTo are checked against the ceiling stored at open; a break misses and does not settle.

The ordinary 60-second observation cache applies to new listed-URL probes, not hops. Add the local guard on open · Hosted session contract.

Add a hosted 402Signal session. Read https://402signal.com/developers/hosted-session. Open with session=open at $0.005; hops are session=hop plus session_id. Do not put the session id in session. Hops must not probe or call a facilitator. This is not the merchant Session Client. wrapExactAuthorize covers open with require_route_binding; hops do not wrap. Do not request funds without existing operator authorization.