BTCPayServer Payment Forward

At Bitcoin Beach Brazil, we are running a MyNodeBTC with BTCPayServer as PoS for small businesses and Virtual BTC Hats for our local street artists. This script is useful when you need receive funds in your node and forward to other wallets automaticly.

How it works

When a invoice generated by BtcPayServer is settled and the Lightning payment is received in our local node, the BtcPayServer Webhook will call a local PHP file, to forward the payment to the end-user wallet and they receive the funds instantly on BlueWallet, connected to LNDHub and LNBits.

Requirements

MyNodeBTC
BTCPayServer
LndHub
LNBits
BlueWallet Mobile
PHP-FQM, BC, JQ

Server Instalation Instrucions

Download the files and run the installation script!

sudo su 
cd /home/admin
mkdir scripts
cd scripts
git clone https://github.com/BitcoinBeachBR/BtcPayServer-Payment-Forward
cd BtcPayServer-Payment-Forward
chmod 755 install.sh
./install.sh

Running the installation script for the first time? Restart Nginx

# /etc/init.d/nginx restart

Run the command below to test if the files are being created at /mnt/hdd/BTCPAYSERVER/invoices

# curl --insecure -d "{}" -X POST http://127.0.0.1:44331/log.php?token=123456789
# ls -la /mnt/hdd/BTCPAYSERVER/invoices

Some routers doe not redirect internal external ports to internal networks. To mitigate that, put an address resolving to loopback address in /etc/hosts

127.0.1.1       myNode  your.somedomain.io

Set the ONG to split fee, and make a donation. Insert the LNDHUB INVOICE URL of the ONG Wallet, and the rate. In the example bellow, the ONG will receive 50% of the fee.

# /mnt/hdd/BTCPAYSERVER/bin/psql_query "insert into charity(id,rate,url) values ('ong_name', 0.5, 'lndhub://invoice:XXXXXXXXXXXXXXXXXX@https://lnbits.jericoacoara.io:5001/lndhub/ext/')" insert

Set guard_btcpayserver to start automaticly after reboot. Add this line to /etc/rc.local, before script "exit 0"

( sleep 300; /mnt/hdd/BTCPAYSERVER/bin/guard_btcpayserver ) &

LNBits Payer Wallet Configuration

Create a wallet on LNbits. Demo server htpps://lnbits.jericoacoara.io:5001 and name it as Payer Wallet
Backup the link generated for your LNBits wallet in a safe location. There are no way to recover.
Go to Extensions and activate LndHub
In the menu, click on LndHub Extension
Copy LNDHUB ADMIN URL
Include your LNDHUB ADMIN URL in /mnt/hdd/BTCPAYSERVER/conf/payer.conf.sample
After edit the file and save, run the command to in the shell to rename it

# mv /mnt/hdd/BTCPAYSERVER/conf/payer.conf.sample /mnt/hdd/BTCPAYSERVER/conf/payer.conf

Run the Script

Running the script first time

# ./mnt/hdd/BTCPAYSERVER/bin/guard_btcpayserver

User Interface Configuration Instrucions

LNBits Configuration

Create a wallet on LNbits. Demo server htpps://lnbits.jericoacoara.io:5001\n
Backup the link generated for your LNBits wallet in a safe location. There are no way to recover.
Go to Extensions and activate LndHub
In the menu, click on LndHub Extension
Copy LNDHUB INVOICE URL
Leave the screen open for the next 2 steps

BlueWaleet Configuration

Click on Create Wallet
Import Wallet
Scan the QRCode LNDHUB ADMIN URL and import
Remember to backup your wallet link, and don't share it with anyone.

BTCPayServer

Create an account on BTCPayServer. Demo server htpps://btcpay.jericoacoara.io
Create a store
In Settings, Payment Methods, setup use the Lightning Wallet from the Local Node
In Checkout Appearance at Invoice Settings BTC (Off-Chain) as default payment method on checkout
In Webhooks click on + Create New Webhook
In Payload URL insert http://127.0.0.1:44331/log.php?token=**YOUR LNDHUB INVOICE URL or if using LNPAY, use as lnpay://nomedousuario@somehost.com ENCODED IN BASE64**
To encode your LNDHUB INVOICE URL or LNPAY URL, use this tool.
The final Payload URL will look like this http://127.0.0.1:44331/log.php?token=bG5kaHViOi8vaW52b2ljZTowZmNiMTY5MmVjNGM0NjUxODc1ZGExMmVlNjgwNjJhOUBodHRwczovL2xuYml0cy5qZXJpY29hY29hcmEuaW86NTAwMS9sbmRodWIvZXh0Lw==
Activate *Automatic redelivery(
In Events select Send specific events and check A payment has been settled
Add Webhook

Other Features under development

Zero Fee Transactions Self-payments are not allowed, then, to not need a second node for the users wallets and maintain the funds locally, we created an private channel with 0 fee, connected to the node of our DEV. Basicly when the script is called, we will force to use this 0 fee channel to transfer the funds direcly to the end-user wallet back to our local node, but now controled by the user.
The payments with more than 100.000 sats are paid using the lndcli command line

Payment Forward Fee Policy

We are charging 2% flat fee for all forwards.
50% of the charged fee is donated to Xavi Surf Kids, the most important social project of Jericoacoara.
You can change the fee in your self hosted script, by changing the RATE in payer.conf

No Warranty

Version Alpha. Use at your own risk.

PraiaBitcoin/BTCPayServer-Payment-Forward