Accept Pix payments in your BTCPay Server store and receive funds in DePix (a Liquid-based BRL stablecoin). This guide is written for BTCPay store owners and server admins and focuses on setup and day-to-day use.
- Adds Liquid Network Stablecoin DePix as a payment method to your BTCPay store.
- Adds Pix as a payment method to your BTCPay store (via DePix).
- After you save a valid DePix configuration, Pix can be enabled and appears on newly created invoices (from Invoices) and in your Point of Sale (POS) apps.
- Provides a Pix Transactions page to monitor deposits and statuses.
- Funds settle to your DePix (Liquid) wallet.
Community plugin. Not affiliated with BTCPay Server or DePix. It’s new, so treat it as experimental for now. Feedback is welcome!
- BTCPay Server 2.x
- A DePix partner API key — request at https://www.depix.info/#partners
- Install the plugin in BTCPay (Plugins → Manage Plugins → search for DePix).
- Restart BTCPay when prompted.
When installed, the DePix (Liquid) asset is prepared for your store. You only need to create your DePix wallet and configure DePix (store-level or server-level) to enable Pix payments.
- In BTCPay: Plugins → Manage Plugins → install SamRock; open SamRock and scan the pairing QR with the Aqua app.
- Wallets → Liquid Bitcoin → Settings → Derivation Scheme → copy the LBTC xpub.
- Wallets → DePix → Connect an existing wallet → Enter extended public key → paste the LBTC xpub → Continue.
Result: BTCPay derives Liquid/DePix receiving addresses from this xpub, so deposits go directly to your Aqua wallet.
(Only the public key is used; no private keys leave Aqua.)
- Wallets → DePix → Create new wallet → Hot wallet.
- To spend from your own Elements/Liquid node later, import the generated keys using Liquid+ and
elements-cli(see Balance and spending DePix).
DePix can be configured in one of two places:
Path: Wallets → Pix → Settings
Use this when:
- You want store-specific behavior (fee/whitelist) and full control at store level, or
- Your server admin did not configure DePix globally.
Path: Server Settings → Pix (Pix Server Settings)
Use this when:
- You run a BTCPay Server instance and want a default configuration for many stores with same API Key and Webhook.
- If the store has a complete store configuration (API key + webhook secret), store config is used.
- Otherwise, if the server has a complete server configuration, server config is used.
- If neither exists, Pix cannot be enabled.
When a store is using server configuration, the store does not manage webhook secrets. Webhook registration is handled by the server admin.
- Go to Wallets → Pix → Settings
- Paste your DePix API key and click Save
- (Optional) Configure store behavior (only applies when the store has its own API key):
- Pass fee to customer
- Whitelist mode
- (Optional) Configure split payments:
- DePix Split Address: wallet that receives the split portion
- Split Fee: percentage of the Pix amount sent to the split address
- Both fields are required together; leave both empty to disable split
Example use cases for split payments:
- Merchant gateway: you provide Pix via your Eulen API + BTCPay setup and charge a platform fee.
- Affiliates: automatically send a commission to an affiliate wallet per sale.
- Coproduction: split course sales between producer and coproducer wallets.
- Marketplace: route a platform fee to your wallet while the seller receives the rest.
- Local partnerships: split revenue between venue and service partner.
This is for BTCPay Server admins who want to configure DePix once and let stores inherit it.
- Go to Server Settings → Pix (Pix Server Settings)
- Paste the server DePix API key and click Save
- Configure defaults for stores that rely on server config:
- Pass fee to customer
- Whitelist mode
After you click Save (either in store settings or server settings), the page will show:
- Webhook URL
- One-time secret
- A ready-to-copy Telegram command
Do this immediately: copy the Telegram command before refreshing or leaving the page.
The secret is one-time view. If you miss it, you must Regenerate secret and click Save again.
In the DePix Telegram bot (Eulen), run the command exactly as shown on the page.
Notes:
Stores using server configuration do not have access to the server secret. The server admin should register the webhook.
- Invoices: create an invoice as usual; customers will see Pix as a payment method.
- POS: generate charges from your Point of Sale; Pix is available.
- Transactions: go to Wallets → Pix to track Pix deposits (status, ID, amount, time, etc.).
- DePix Balance: go to Wallets → DePix to track the received DePix converted from successful Pix transactions.
After a Pix payment, funds settle to your DePix (Liquid) wallet.
- SamRock + Aqua (xpub): funds go to your Aqua wallet. Spend them normally from Aqua — you do not need Liquid+ or
elements-cli. - BTCPay Hot Wallet: follow the steps below to spend via your Elements/Liquid node (Liquid+).
-
Install the Liquid+ plugin in BTCPay Server.
-
Click on Liquid at the sidebar under the Store Settings.
-
Use Liquid+ to run the key imports on your Elements/Liquid node:
importprivkey <WIF_PRIVATE_KEY>importblindingkey <ADDRESS> <BLINDING_KEY>
Import every address you plan to spend from. If you generated a new address in BTCPay, import its privkey and blinding key.
-
Rescan the chain so the wallet finds past UTXOs belonging to those keys (faster if you know an approximate start height):
elements-cli rescanblockchain 0
You can pass a higher start height to speed things up, e.g.
rescanblockchain 120000. -
Verify your balance:
elements-cli getbalances
(DePix Asset ID: 02f22f8d9c76ab41661a2729e4752e2c5d1a263012141b86ea98af5472df5189)
-
Send DePix using
sendtoaddresswith the asset id that shown in getbalances as the last argument:elements-cli sendtoaddress "<DEST_LIQUID_ADDRESS>" <AMOUNT> "" "" false false null null null "<DEPix_ASSET_ID>"
This constructs and broadcasts a confidential transaction of the specified asset (DePix) to the destination so you can swap for BTC.
Notes
- Fees are paid in L-BTC on Liquid. Keep a small L-BTC balance in the same wallet to cover network fees.
Where do I get the DePix API key? At https://www.depix.info/#partners
Is the webhook mandatory? No, but it’s recommended so you receive real‑time payment updates.
Pix doesn’t appear as a payment method. What should I check? Make sure DePix is configured either in Wallets → Pix → Settings (store) or by the server admin in Server Settings → DePix (server). Once a complete configuration exists, Pix can be enabled and will appear on invoices/POS.
Open an issue on the repository with details of your problem or suggestion. Pull requests are welcome.
MIT.