-
Notifications
You must be signed in to change notification settings - Fork 3
FAQ
To set up a BTCPay Server, you can follow the official BTCPay Server Deployment Guide. The guide provides detailed steps for installing and configuring your server, including various hosting options and best practices. If you're new to BTCPay Server, this guide is a great starting point to get your server up and running.
The plugin requires access to a JSON-RPC endpoint to interact with the TRON blockchain. By default, it uses the public TronGrid JSON-RPC API.
For small-scale setups, you can use free plans offered by node providers like QuickNode and GetBlock, which are sufficient for most use cases. If you prefer enhanced security and greater control over transaction data, you can choose to run your own TRON node.
To ensure smooth transaction processing, the plugin requires multiple addresses. This approach prevents conflicts between payments and invoices. Each time an invoice is created, a unique address is assigned to the invoice while it is active. Once the invoice is settled or expired, the address becomes free again and can be reused for future invoices. By assigning each invoice to a unique address, it becomes easier to track payments accurately, even when multiple invoices are active simultaneously.
The plugin is compatible with all wallets that support USD₮ on the TRON blockchain (TRC-20).
We have tested and confirmed compatibility with the following:
- TronLink
- Ledger wallets
If you have tested other wallets, please share your findings with us to help improve the plugin.
The plugin listens for incoming transactions using the configured JSON-RPC endpoint. Once a transaction is detected and validated on the TRON blockchain, the payment is marked as processing in the BTCPay Server system. The plugin ensures accurate confirmations by monitoring blockchain data directly, and after confirmations, the payment is marked as settled. The number of confirmations will depend on your store speed policy and this code.
If payments are not being detected:
- Verify that the JSON-RPC endpoint is correctly configured and accessible.
- Verify the synchronization of the server, whether through the UI or directly via the logs.
- Check if the transaction was successfully broadcast and confirmed on the TRON blockchain.
If the issue persists, please open an issue in this repository.
Unfortunately, payments sent to the wrong address cannot be recovered. Blockchain transactions are immutable, meaning they cannot be reversed once completed. Ensure that customers carefully scan the QR code or copy the correct payment address provided by the checkout page. Hopefully, addresses embed a checksum, which should help prevent this situation.
Yes, like all blockchain transactions, payments sent via the TRON network incur network fees (also known as gas fees). These fees are required to process the transaction on the TRON blockchain. The plugin itself does not add any extra fees beyond what is required by the TRON network.
TRON network fees are divided into two components: Bandwidth and Energy:
- Bandwidth: Used for sending data across the network. Each user receives a certain amount of free bandwidth daily. If this is exceeded, additional Energy is used to pay for the extra bandwidth.
- Energy: Used to execute smart contract operations (such as sending a transaction). The amount of Energy required depends on the complexity of the transaction.
How to get more Bandwidth:
To obtain additional Bandwidth:
-
Stake TRX tokens:
Staking TRX also grants you extra Bandwidth. When you stake TRX, you receive both Energy and Bandwidth, allowing you to send more data and process more transactions. Staking more TRX will result in more Bandwidth allocation. -
Use free daily Bandwidth:
Each TRON account is granted a certain amount of free Bandwidth daily. If you use this daily allowance, you may need to stake additional TRX to obtain more Bandwidth for the day.
How to get more Energy:
There are two primary ways to obtain more Energy on the TRON network:
-
Stake TRX tokens:
You can stake your TRX (TRON's native cryptocurrency) to earn both Energy and Bandwidth. Staking TRX tokens is a way to "lock" your TRX in the network, and in return, you receive Energy and Bandwidth as rewards. The more TRX you stake, the more Energy you can generate.- To stake TRX, use a TRON wallet (e.g., TronLink) to stake your TRX and select how much Energy you'd like to receive.
- TRX that is staked can be unstaked after a period (usually 3 days), so it’s a temporary commitment.
-
Purchase Energy:
You can also purchase Energy directly on the TRON network through certain wallet services or exchanges. This option allows you to pay for the Energy you need without staking TRX.
TRON's fee system is designed to be user-friendly, with low fees for most regular transactions. However, the fees can fluctuate based on network activity, especially during periods of congestion or when interacting with complex contracts.
Yes, the plugin can be used alongside BTCPay Server's other supported payment methods, such as Bitcoin and Lightning. Each payment method operates independently, and customers can choose their preferred option at checkout.
Currently, the plugin is designed specifically for USD₮ (TRC-20) on the TRON blockchain. While it may technically be possible to extend support to other TRC-20 tokens, this is not officially supported or tested. Contact us if you are interested in exploring this feature.
At the moment, there are no plans to support other blockchains. However, we are always interested in hearing feedback and understanding user needs. If you would like to see support for a specific blockchain, please share your thoughts by contacting us via an issue.