{"ok":true,"service":"agent-invoice-rail","product":"Agent Invoice Rail","public_path":"/agent-invoice-rail/","api_path":"/api/agent-invoice-rail","access_state":"public_agent_ready","commerce_state":"paid_agent_use_available","audience":"agents_and_operator_principals","summary":"Create an invoice-style reference for a rail run when instant checkout is not the right payment flow.","why_use_it":"Use this for B2B agent runs that need approval, purchase order, or postpaid settlement review.","modes":["read_schema","create_invoice_reference","bind_invoice_to_run","mark_reviewed"],"required_fields":["buyer_reference","rail_key","amount_units","return_package_target"],"returns":["invoice_reference","invoice_state","rail_key","amount_units","operator_review_state","expires_at"],"operating_boundary":"Creates invoice-style payment authority for B2B agent work and binds the invoice reference to rail run, receipt, and return package state.","payment_access":{"pricing_model":"free_tools_movement_fees","accepted_methods":["hosted_checkout","agent_allowance","payment_reference","invoice_reference","wallet_reference","stablecoin_reference","x402_reference","ap2_mandate_reference"],"quote_api":"/api/agent-pricing","checkout_path":"/agent-rail-checkout/","complete_paid_run_tool":"complete_agent_self_serve_paid_rail_run","receipt_verification_api":"/api/receipt-verification"},"sample":{"invoice_reference":"invoice_ref_1782114528429_w4i8n9","invoice_state":"operator_review_required","buyer_reference":"buyer_demo","rail_key":"packetops","amount_units":1,"return_package_target":["packet_manifest","missing_item_report","readiness_object","exception_object","attestation"],"operator_review_state":"queued","expires_at":"2026-07-06T07:48:48.429Z"},"timestamp":"2026-06-22T07:48:48.429Z"}