FiberFlow — self-hosted merchant payments for Fiber (try the live demo)

Hey everyone,

I’ve been building FiberFlow — merchant payment infrastructure for the Fiber Network on Nervos CKB.

Think of it as a checkout layer stores can plug into: landing page, merchant dashboard, hosted payment page, invoice API, and webhooks — similar in role to Stripe Checkout, but for Fiber. You run it yourself with your own wallet key. Customers pay with any Fiber-compatible wallet.

In plain terms: customer checks out → FiberFlow shows a payment page → they pay over Fiber → your store gets a webhook and you fulfill. You keep the keys; there’s no hosted cloud that holds your funds.

This is infrastructure for merchants and developers, not a consumer wallet app.

What it includes

  • Fiber node (Docker) — your wallet + payment channels
  • API — invoices, auth, webhooks
  • Frontend — landing page, merchant dashboard, customer checkout
  • Example Next.js store already wired to FiberFlow

Repo: https://github.com/chukwuma619/fiberflow

Try it without installing anything

Role Link What to do
Demo store (customer) https://fiberflow-eight.vercel.app/ Register / sign in → add items → checkout → pay on the FiberFlow payment page
Merchant dashboard https://backr.site/ Sign up → create a store → explore invoices, API keys, webhooks

Both are public and already connected.

Paying on the demo (testnet)

You’ll need a Fiber node on testnet (Fiber Studio recommended, or the Fiber quick start), then connect to the demo peer and open a channel:

  • Peer: 03bf4208b9ada97a5589ef9924819fe511b2a5e9ed3812df21a79435d39a147b10
  • Multiaddr: /ip4/49.13.159.45/tcp/8228/p2p/Qmc9gzZB7aHYrVNxpakaQ8mLFchnnkesLhDfPPJEHQNbPt

Wait until the channel is ChannelReady, give it a few minutes, then check out on the demo store and pay from your node.

CLI example:

export PEER_PUBKEY=03bf4208b9ada97a5589ef9924819fe511b2a5e9ed3812df21a79435d39a147b10

fnn-cli peer connect_peer \

--pubkey “$PEER_PUBKEY” \

--address “/ip4/49.13.159.45/tcp/8228/p2p/Qmc9gzZB7aHYrVNxpakaQ8mLFchnnkesLhDfPPJEHQNbPt”

fnn-cli channel open_channel \

--pubkey “$PEER_PUBKEY” \

--funding-amount 5000000000000 \

--public true

Self-host it

Full walkthrough (clone → wallet key → Neon Postgres → start → fund → open channel → dashboard):

https://github.com/chukwuma619/fiberflow/blob/main/docs/SELF_HOSTING.md

You’ll need Docker, Bun, a Postgres DB (e.g. Neon), ckb-cli, and ~100k testnet CKB from the faucet.

Merchant API / webhook integration guide:

https://github.com/chukwuma619/fiberflow/blob/main/docs/MERCHANT_INTEGRATION.md

Status

Active development. Prefer testnet until you’re comfortable with channels and backups. There’s no Shopify/WooCommerce plugin yet — any site that can call an HTTPS API and receive webhooks works; you can also create invoices from the dashboard and share payment links.

Feedback, bug reports, and “I tried paying and …” reports are very welcome. Happy to help anyone get a first test payment through.

6 Likes