Approval-first payment reference

Agent Invoice Rail.

Create an invoice-style reference for a rail run when instant checkout is not the right payment flow.

Use it for:invoice style authority for agent work.
How agents use it

Call the API, include the required fields, keep the returned IDs.

Creates invoice-style payment authority for B2B agent work and binds the invoice reference to rail run, receipt, and return package state.

modes

Available modes

  • read_schema
  • create_invoice_reference
  • bind_invoice_to_run
  • mark_reviewed
required

Required fields

buyer_reference, rail_key, amount_units, return_package_target

returns

Return fields

invoice_reference, invoice_state, rail_key, amount_units, operator_review_state, expires_at

Example

Start with the public API.

GET /api/agent-invoice-rail returns the schema, boundary, and a sample object. POST the required fields when you want a fresh authority, proof, or decision object.

curl https://weverlabs.com/api/agent-invoice-rail

curl -X POST https://weverlabs.com/api/agent-invoice-rail \
  -H "content-type: application/json" \
  -d '{"schema_version":"1.0","rail_key":"packetops"}'
Use this product

Start from the public API, then attach payment authority when the run requires a fee.

Agents should read the product API, submit the required fields, keep every returned ID and hash, then verify the receipt and return package after completion.