1. Configure Bitcoin Payments on the Store Settings Level

To make the Bitcoin Payments feature available on your checkout page, you first need to configure one of the available BTC payment methods on the Store Level:

a.) Lightning Network Configuration

To make the Lightning Network method available on the checkout page, you need to provide your Lightning Node connection string and save it on the Store Level.


b.) On-Chain Method Configuration

To make the On-Chain Method available on your checkout page, you need to provide your BTC wallet's extended public key and save it on the Store Level.


Important: After specifying your wallet's extended public key and clicking "Connect", the system will ask you to confirm your wallet addresses. These addresses will be used for creating the transactions.

Please double-check that all of the addresses that you’ve provided match your BTC wallet's addresses.


c.) SMTP Server Settings

SMTP Server Settings are required to use Email Rules. These settings will be used to send emails to your customers regarding Bitcoin Payments.


d.) Email Rules

You can choose which events to email your customers about during the checkout process.

The list of available events are:

Invoice Created - The Bitcoin Invoice was created and the Bitcoin payment pop-up appeared to the customer on the checkout page.

Invoice Expired - The created invoice expired (invoices last for 15 minutes).

Invoice Payment Received - A new transaction was created for the customer's Bitcoin invoice.

Invoice Settled - The Bitcoin Invoice was fully paid by the customer.

You can create whatever subject lines and body text that you want for these emails, including using dynamic variables to create customized emails for each customer. For example, your body text could begin with:

“Dear %customer_first_name” 

Which would show up to the recipient as, “Dear (their first name)”

Other examples of dynamic variables you could use include:

  • %customer_last_name

  • %invoice_id, %invoice_amount

  • %invoice_currency

  • %invoice_url

The email body can also contain both HTML and CSS.



2. Bitcoin Payments Appearance on the Checkout Page

After configuring and enabling one of the available Bitcoin payment methods, the "Pay with Bitcoin" option will become available on your checkout page.


When the customer clicks "Pay with Bitcoin", a new Invoice will be generated for them and a pop-up will appear with all the payment information necessary for creating a transaction and processing their order.


If you configured and enabled both the On-Chain and Lightning Network methods, the customer will be able to choose between them within the pop-up.

To pay for the invoice, the customer can scan the QR code via BTC wallet or copy the merchant’s wallet address/Bolt 11 Invoice address.


A BTC invoice lasts for 15 minutes. When it expires, the customer will receive a notification. They can generate a new invoice by clicking "Pay with Bitcoin" again.


3. Bitcoin Payments Refunds Process

After creating a refund on your platform, a refund page will be generated. A link to it will be shared with you in the order comments section and with the customer in an email. Funds will not be automatically refunded to the wallet/lightning node from which the customer paid.


This link will also be shared with your customer through an Order Refund Email.

Your customers will be able to specify their Lightning Invoice or BTC Wallet address where they want funds to be refunded.

Important: Funds will not be automatically refunded to the customer’s address unless your merchant's wallet is a BTC Hot Wallet (always online) or in case your configured Lightning Node doesn't provide the functionality of an automatic payment processor.

After providing a destination address and clicking "Claim Funds", a new Claim will be created with "Awaiting payment" status.

In case the configured BTC wallet is not of a "Hot" type (always online) or your Lightning Node doesn't support automatic payment processors triggered by 3rd party Apps, you can copy the Destination address of your customer on the refund page and manually send the necessary amount of funds via your BTC wallet.



4. Bitcoin Orders Transaction Fee

On the first day of every month, the Dominate App will automatically calculate the sum of all of the orders that were paid for with Bitcoin Payments and charge you 1% of that amount.

Funds will be captured from the credit card information you provided during the first step (in My Account -> Payment Information).

If the transaction is declined for some reason, Dominate will try to capture these funds automatically three more times (on the 3rd, 10th, and 19th days of the month). If funds are still not captured, Bitcoin payments will be disabled for your account until you manually pay the invoice.

You can pay the Bitcoin Payments Fee Invoice by finding it in the Dominate Admin panel -> My Account -> Billing History.

You can always check Invoice details by clicking the three dots icon and clicking "View Details."