https://github.com/lnbits/splitpayments

https://github.com/lnbits/splitpayments

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/lnbits/splitpayments
• Owner: lnbits
• License: mit
• Created: 2023-02-14T14:44:14.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-19T16:31:33.000Z (5 months ago)
• Last Synced: 2024-06-21T03:26:08.913Z (5 months ago)
• Language: Python
• Size: 230 KB
• Stars: 13
• Watchers: 4
• Forks: 6
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-lnbits - Split Payments - Split Payments extension allows for distributing payments across multiple wallets. (Uncategorized / Uncategorized)

README

        
# Split Payments - [LNbits](https://github.com/lnbits/lnbits) extension

For more about LNBits extension check [this tutorial](https://github.com/lnbits/lnbits/wiki/LNbits-Documentation#use-cases-of-lnbits)

## Have payments split between multiple wallets

LNbits Split Payments extension allows for distributing payments across multiple wallets. Set it and forget it. It will keep splitting your payments across wallets forever.

## Usage

1. After enabling the extension, choose the source wallet that will receive and distribute the Payments

![choose wallet](https://i.imgur.com/nPQudqL.png)

2. Add the wallet or wallets info to split payments to

![split wallets](https://i.imgur.com/5hCNWpg.png) - get the LNURLp, a LNaddress, wallet id, or an invoice key from a different wallet. It can be a completely different user on another instance/domain. You can get the wallet information on the API Info section on every wallet page\

 ![wallet info](https://i.imgur.com/betqflC.png) - set a wallet _Alias_ for your own identification\

- set how much, in percentage, this wallet will receive from every payment sent to the source wallet

3. When done with adding or deleting a set of targets, click "SAVE TARGETS" to make the splits effective.

4. You can have several wallets to split to, as long as the sum of the percentages is under or equal to 100%. It can only reach 100% if the targets are all internal ones.

5. When the source wallet receives a payment, the extension will automatically split the corresponding values to every wallet.

   - on receiving a 20 sats payment\

     ![get 20 sats payment](https://i.imgur.com/BKp0xvy.png)

   - source wallet gets 18 sats\

     ![source wallet](https://i.imgur.com/GCxDZ5s.png)

   - Ben's wallet (the wallet from the example) instantly, and feeless, gets the corresponding 10%, or 2 sats\

     ![ben wallet](https://i.imgur.com/MfsccNa.png)

IMPORTANT:

- If you split to a LNURLp or LNaddress through the LNURLp extension make sure your receipients allow comments ! Split&Scrub add a comment in your transaction - and if it is not allowed, the split/scrub will not take place.

- Make sure the LNURLp / LNaddress of the receipient has its min-sats set very low (e.g. 1 sat). If the wallet does not belong to you you can [check with a Decoder](https://lightningdecoder.com/), if that is the case already

- Yes, there is fees - internal and external! Updating your own wallets on your own instance will not cost any fees but sending to an external instance will. Please notice that you should therefore not split up to 100% if you send to a wallet that is external (leave 1-2% reserve for routing fees!). External fees are deducted from the individual payment percentage of the receipient





## Sponsored by

[![](https://cdn.shopify.com/s/files/1/0826/9235/files/cryptograffiti_logo_clear_background.png?v=1504730421)](https://cryptograffiti.com/)