Reusable payment offers for Fiber
Fiber Offers is reusable payment infrastructure for merchants, wallets, and services. A signed offer stays stable while the resolver creates a new Fiber invoice for each payment attempt.
How it works
- A merchant signs and publishes a reusable offer containing the accepted asset and price constraints.
- A wallet discovers the offer through a payment link, QR code, Fiber Address, or encoded payload and verifies its signature.
- The wallet checks readiness, requests a fresh invoice with an idempotency key, and sends the invoice through Fiber only after confirmation.
- The resolver records the resolution and lets merchant systems observe lifecycle changes through webhooks, receipts, and reconciliation exports.
Follow the separate Quickstart to run this flow against the local two-node Fiber testnet fixture.
Choose your integration path
Understand the offer
Learn the signed format, pricing constraints, Fiber Addresses, and QR payloads before creating an integration.
Use the HTTP API
Register offers, resolve invoices, check readiness, inspect resolutions, and retrieve reconciliation exports.
Build a wallet flow
Verify an offer, present readiness feedback, use idempotency, and explicitly execute a Fiber payment.
Operate merchant payments
Set up webhooks, settlement tracking, receipts, reconciliation, and background workers.
Connect Fiber nodes
Run live RPC checks, topology diagnostics, route dry-runs, and guarded direct-channel fixtures.
Run your own deployment
Connect a private merchant Fiber node, generate secrets, start Docker, and expose only the resolver through HTTPS.
Integrate the SDK
Use the Node SDK to compose resolver, readiness, topology, and payer-side payment behavior.
Live Fiber by default
The standard runtime creates real Fiber invoices and automatically polls settlement state. An explicit mock adapter remains available only for automated tests and isolated UI development through npm run dev:mock.
Set FIBER_RPC_URL when the resolver should request and poll actual invoices from a Fiber node. Configure payer and merchant RPC URLs to add topology and route diagnostics.