Skip to main content
LightningBreez

Lightning wallets

Accept Lightning Payments From Breez Wallet Users

Breez is a non-custodial Lightning wallet, and the Breez SDK powers Lightning in many other apps. Accept Lightning through the Amboss Payments API and you can receive from Breez users directly, with no per-platform integration.

The rail is invisible to the payer

Your customer never has to think about Bitcoin or Lightning. They send from Breez; you accept Lightning once and receive from anyone who can pay an invoice.

Step 1

A Breez user

holds bitcoin in Breez and chooses to send a payment over the Lightning Network.

Step 2

The Lightning Network

routes the payment in seconds. Neither side picks a "rail" — Lightning is the shared standard.

Step 3

Your business

receives the settled payment through the Amboss Payments API, the same way for every wallet.

Yes. Breez is a non-custodial Lightning wallet, and the Breez SDK powers Lightning inside many other apps, so a business that accepts Lightning through the Amboss Payments API can receive from all of them directly. Breez reports that more than 75 apps have integrated its SDK, per the Breez SDK product page, so one integration reaches a wide base of Breez wallet Lightning users.

Does Breez support Lightning?

Yes, natively, for both sending and receiving. Breez is built around the Lightning Network, and a Breez user pays you by scanning the Lightning invoice your checkout displays. Because Breez is self-custodial, the user signs the payment from their own wallet rather than a balance held by a third party.

CapabilityBreez over Lightning
Send over LightningYes, Bolt11 invoice, Lightning address, LNURL
Receive over LightningYes
On-chain supportYes, send and receive to a Bitcoin address
CustodyNon-custodial (keys are held only by the user)
Developer reach75+ apps have integrated the Breez SDK
Send feeRouting fee, plus setup cost on first channel

The Breez SDK repository on GitHub states the model plainly:

The Breez SDK provides developers with a end-to-end solution for integrating self-custodial Lightning payments.

Breez offers two implementations, both non-custodial: a Greenlight version that runs a Lightning node on demand with keys staying on the user device, and a nodeless version built on the Liquid sidechain. Either way the sending experience is an in-app scan and confirm, and the funds belong to the user.

How do you receive payments from Breez users?

You accept Lightning once and every Breez user can pay you. The flow is four steps:

  1. Integrate the Amboss Payments API and create a Lightning invoice for the order amount.
  2. Display the invoice at checkout as a QR code or a copyable string.
  3. The Breez user scans or pastes it and confirms the payment from their wallet.
  4. The payment routes over Lightning and settles to you in seconds.

The payer never chooses a network and never needs an account with you. Live Lightning capacity and routing data are published on the Amboss Space Lightning explorer.

How do you integrate Breez receiving into checkout?

Receiving from Breez is the standard Lightning receive flow: create an invoice, then confirm settlement. The invoice format is defined by the BOLT 11 payment-encoding specification, so one integration accepts Breez, Strike, Cash App, and every other Lightning sender.

The Amboss Payments API is GraphQL. A single create_receive mutation returns the BOLT 11 invoice you show the customer:

mutation CreateReceive {
  payment {
    transaction {
      create_receive(
        input: {
          wallet_id: "your-wallet-id"
          amount: "50000"
          description: "Order #1234"
        }
      ) {
        status
        payment_request
        payment_hash
      }
    }
  }
}

Send it to the https://rails.amboss.tech/graphql endpoint with your x-api-key. The payment_request field is the lnbc... string you render as a QR code, and you confirm settlement with the payment.completed webhook, as documented in the Amboss Payments API documentation. Because Breez ships the same protocol inside many apps, Bitcoin Magazine quotes Breez co-founder Roy Sheinfeld on the speed of adding Lightning with the SDK:

I can tell you from our experience working with our partners, it takes days to add Lightning payments to their application.

Where does Amboss Payments fit?

Lightning is an open standard, so the same integration receives from a self-custodial wallet like Breez and from a custodial exchange the same way. Amboss Payments provides that integration as a managed API on the Lightning Network, with no node to run. To talk through volume, settlement timing, or pricing, contact the Amboss team.

Frequently asked questions

Common questions about receiving Lightning payments from Breez users.

Start accepting payments from Breez users

The Amboss Payments API gives you a single Lightning integration that receives from Breez and every other Lightning wallet. Get started on Rails, read the docs, or book a discovery call.