pull down to refresh

Bunch is a drop-in loyalty layer for Bitcoin-accepting merchants. It tracks punches locally alongside existing payment flows, without touching invoices or custody. Made for the @btcpp Taipei hackathon.

Most loyalty rewards programs force merchants to adopt expensive platforms and force customers to give up personal data. At the same time, Bitcoin merchants often already have a working checkout and don’t want to replace it just to offer simple rewards.

Inspired by the simplicity of paper punch cards, what would a digital punch card look like if it worked with Bitcoin payments, respected privacy, and didn’t introduce a new platform or payment system?

Bunch is the answer.

Integration with Bitcoin POS SystemsIntegration with Bitcoin POS Systems

Bunch is designed to work alongside existing Bitcoin payment infrastructure like BTCPay Server, LNbits, or any Lightning/Bitcoin payment system. Bunch never creates invoices or handles payments—it only tracks loyalty rewards after payment confirmation.

How It WorksHow It Works

  1. Merchant generates purchase QR → Bunch creates a unique purchase nonce (single-use, 10-minute expiry)
  2. Customer scans QR → Customer's device claims the nonce and waits for confirmation
  3. Payment happens → Merchant processes payment via their existing POS system (BTCPay, LNbits, etc.)
  4. Merchant confirms payment → Merchant marks the purchase as paid in Bunch, awarding the punch
  5. Customer sees update → Real-time sync updates customer's progress

What it doesWhat it does

Bunch is a drop-in customer loyalty punch-card layer for Bitcoin-accepting merchants.

It works alongside existing Bitcoin payment flows (e.g., BTCPay, LNbits, zap-based payments) without creating invoices or handling money.

  1. Merchants create a punch card (e.g. “Buy 5, get 1 free”)
  2. Customers join a session by scanning a QR
  3. Each purchase generates a one-time QR
  4. After the merchant confirms payment, a punch is awarded
  5. When the card is full, the customer redeems in person with merchant confirmation
  6. No accounts. No customer database. No new payment system.

CodeCode

GitHub: https://github.com/NotThatKindOfDrLiz/bunch

0 sats \ 0 replies \ @AG 12h

the BTCpay and LNbits integrations are really useful. I'll test this out. Thank you

reply