Metabootik PoC : on product sale, send commission to a defined Lightning address

[Tirodem]

Following https://github.com/B2Bitcoin/B2BitcoinBootik/issues/96 Restricted to https://github.com/B2Bitcoin/B2BitcoinBootik/issues/168 whitelisted npubs

Prerequisite

• create a "Referral" toggle on /admin/product creation/edition form
  • with a "amount" (%, 0-100) input (mandatory if toggle is true)
  • with a "Lightning address" input
  • with a "Whitelisted Bootik" select dropdown (either "Lightning address" OR "Whitelisted Bootik" is mandatory, and we cannot fill both, otherwise raise error)
  • Bootik's displayed here are from https://github.com/B2Bitcoin/B2BitcoinBootik/issues/169
  • give the option to add another amount + lightning address/whitelisted bootik entry
  • raise alert on save when sum of defined amounts is >= 100

Use cases

Setting referral on a product

• When I create a product on my Bootik A, I can define a commission for 0 to n Lightning address (if I want to give a commission to an organism or a person -writer, artist, etc-) or 0 to n Whitelisted Bootiks (for commercial partnership)

Process referral on product sale

• When the product is sold, after the order :
  • send order.items.product.price.amount x order.items.quantity x amount / 100 through lightning to the target adress
  • in case of target whitelisted Bootik, following https://github.com/B2Bitcoin/B2BitcoinBootik/issues/169 & https://github.com/B2Bitcoin/B2BitcoinBootik/issues/168, use the lightning address related to the bootik's npub stocked in database
  • create a post-order transaction to track the payment in database and link it to the origin order ID
  • if the target of the referral is a whitelisted Bootik, send a referral payment notification through nostr message to its npub :
  • with the order infos
  • with the referral amount
  • with the paid price
  • with the lightning transaction ID
  • with the product URL

Process referral payment on target's side

• When Bootik B receive a referral payment notification through NostR
  • if Discovery toggle is off : answer "Cool but I asked for nothing, thanks"
  • if Discovery toggle is on :
  • check the lightning transaction ID and confirm it
  • if KO, log error, stop process
  • if OK, create an order with
    • order.notifications.paymentStatuts.npub = sender Bootik A npub
    • order.payment.method = "Lightning"
    • order.payment.status = "paid"
    • order.payment.paidAt = time of nostR referral payment notification
    • order.items = genetic tip product, like https://github.com/B2Bitcoin/B2BitcoinBootik/issues/174
    • order.items.type = "referral"
    • order.items.name = "Referral"
    • order.items.name = Bootik A npub + product URL from referral payment notification

[Tirodem]

Big question here, I think, is : is it possible to automatically send lightning payment from a request with a rightly setted back-office, or should we include manual validation from the owner of the referred Bootik ? In that case, I shall make it async and change my conditions a bit.

[Tirodem]

Note : for this feature, always consider amounts in SATS, not dependig of the Bootik main currency Note2 : this might force us to stock the 2 amounts when ordering (main currency amount, and SATS real amount if SATS/BTC is 2nd currency)

[Tirodem]

Following talk with Lionel, it seems that we can use lnurl for direct payment from the seller to the referral bootik : https://docs.bitnob.com/docs/pay-lnurl-qr That would make the process easier.

Use case with lnurl :

• when I create product 123456 on Bootik, I can check "referral" toggle (default : false)
• when "referral" toggle is "true" for a product, on /admin/product/{id} interface, I can fill 3 inputs :
  • referral ratio (%, 0-100) (mandatory)
  • target lnurl (mandatory)
  • target npub (optional)
• when user buy product 123546 in qty X on Bootik and order si validated, Bootik :
  • triggers a payment of product 123456 price qty referral ratio to target lnurl
  • if filled, sends a message to target npub with : "Hey, I'm Bootik {meta-title} ({url}). Following the sale of {qty} {produit 123456 name}, you deserved your commission of {referral ratio}, so here's {transaction_id} for your {transaction_amount}. Cheers !"

[coyotte508]

yes we should be able to send sats directly to bootik with it's lightning paymetn address

[Tirodem]

@coyotte508 I rewrote the US considering that

[Tirodem]

Note : instead of using a lightning payment with a lightning address related to a bootik npub, we can think about associating the lightning address of the bootik with its nostr account and use the "Zaps" feature from Nostr. https://thebitcoinmanual.com/articles/nostr-zaps But it seems to be highly UI related, I think it's better to separate the lightning payment from the nostr notification. @ludomire WDYT ?

[ludomire]

Why not both?

[Tirodem]

We indeeed can associate automatically Bootik's lightning address with its NostR account to allow users to give us Zaps and be whitelisted in Zaps pool. Still we'll do with Lightning payment first as I'm not sure it's pertinent to use Zaps from NostR to do lightning payment instead of a direct Lightning payment. I edit https://github.com/B2Bitcoin/B2BitcoinBootik/issues/167 for that.

[coyotte508]

214 should be done first

After that, 1 day I guess