Skip to main content
LightningWallet of Satoshi

Lightning wallets

Accept Lightning Payments From Wallet of Satoshi Users

Wallet of Satoshi is a popular custodial Lightning wallet that gives every user a Lightning address. Accept Lightning through the Amboss Payments API and you can receive from them directly, with the rail invisible to the payer.

The rail is invisible to the payer

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

Step 1

A Wallet of Satoshi user

holds bitcoin in Wallet of Satoshi 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. Wallet of Satoshi is a Lightning-only wallet, so its users can pay any Lightning invoice, and a business that accepts Lightning through the Amboss Payments API can receive from them directly. The app has been downloaded more than 2.7 million times, as shown on the Wallet of Satoshi Google Play listing, so accepting Lightning turns a large mobile user base into people who can pay you.

Does Wallet of Satoshi support Lightning?

Yes, exclusively. Wallet of Satoshi is built only for the Lightning Network, with no on-chain spending path, so every user can send a Lightning payment. To pay you, a customer opens the app, scans the Lightning invoice your checkout displays, and confirms the send.

CapabilityWallet of Satoshi over Lightning
Send over LightningYes, by scanning or pasting an invoice
Receive over LightningYes, via a Lightning address
Lightning address[email protected] on download
US availabilityRemoved from US app stores in late 2023
CustodyCustodial by default, self-custody optional
FocusLightning-only, simplicity first

The Wallet of Satoshi site describes the custodial default plainly:

we hold the keys on your behalf so you can enjoy instant setup and easy recovery.

Keep one regional caveat in mind. CryptoSlate's report on the US withdrawal covers the late-2023 exit:

The company said that it had decided to remove its app from the U.S. and Google app stores and stop serving American users going forward.

How do you receive payments from Wallet of Satoshi users?

You do not build a Wallet of Satoshi integration. You accept Lightning once and every Wallet of Satoshi user becomes a potential payer. The flow is four steps:

  1. Integrate the Amboss Payments API and create a Lightning invoice for the order amount.
  2. Show the invoice to the customer as a QR code or a copyable string at checkout.
  3. The customer scans it inside Wallet of Satoshi and confirms the send.
  4. The payment routes over Lightning and settles to you in seconds. You fulfill the order.

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 Wallet of Satoshi receiving into checkout?

Receiving from Wallet of Satoshi is the standard Lightning receive flow: create an invoice, then confirm settlement. A Lightning invoice is a self-contained string defined by the BOLT 11 payment-encoding specification, so the same code path accepts Wallet of Satoshi, Cash App, and any 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. Wallet of Satoshi users also carry a Lightning address, a human-readable handle defined by the Lightning Address specification:

A Lightning Address allows you to receive Bitcoin over the Lightning Network without a need for a server.

Where does Amboss Payments fit?

Lightning is an open standard, so a single integration receives from a simple custodial wallet like Wallet of Satoshi and from any other sender 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 Wallet of Satoshi users.

Start accepting payments from Wallet of Satoshi users

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