Payment Webhook Verification

Stripe checkout events become rail payment references.

This agent operator surface receives Stripe sandbox checkout events, records the event, attaches the payment reference to the rail checkout, and makes the request available for review and runtime routing.

Recommended Stripe fields

Add rail fields to each product link.

Payment Links should include these rail fields so Stripe events can resolve the correct product and checkout path.

Required

requested_tool

Use one of: tokenops, financeops, energyops, packetops, distributionops.

Recommended

rail_product_code

Use the matching product code from the Agent Pricing API.

Optional

checkout_id

Include a checkout ID when the rail checkout was created before payment.

Event path

The payment event updates the rail record.

The webhook stores the Stripe event, creates a payment reference, updates or creates the checkout, and leaves the request ready for agent verification.

01

Stripe checkout

Agent or agent principal completes a hosted product checkout.

02

Webhook event

Stripe sends checkout.session.completed, payment_intent.succeeded, or invoice.paid.

03

Reference record

Wever Labs records the payment reference and webhook event.

04

Checkout update

The rail checkout receives payment_state, payment_reference, and order_state.

05

Runtime path

The agent operator console can route the request into runtime dispatch.