Beginner’s Guide: Send Automated Order Confirmation Emails From Your BTCPay Store

In Part 1, we set up your Bitcoin store and enabled Lightning payments. In Part 2, we take it further: automate order confirmation emails. Set up dynamic templates for physical products, digital items, or event tickets, test your automation, and keep your customers informed, quickly, smoothly, and for free. No prior coding experience required.

Just Tam

10. September 2025September 10, 2025 · 9 Min. Lesezeit9 min read · Aktualisiert am 12. September 2025Updated September 12, 2025

Setup: BTCPay Server hosted on Bitcoin Aruba with Gmail email integration

Keep in Mind#

What You’ll Need#

Decisions to Make#

Get Started#

⚠️ Jump to Step 4 if you already have Gmail with 2FA enabled#

1. Create a New Google Account#

Review your account info

Choose your settings

Scroll to the bottom

🔸 You should see

Web & App Activity - Off YouTube History - Off Personalized ads - Off

✅ Google account created successfully

image#

Important

⚠️ A BTCPay Server admin could potentially access your Google account. Creating a fresh account ensures you haven’t inadvertently shared more than intended.

2. Enable 2-Step Verification (2FA)#

Note

ℹ️ There are 4 ways to add 2FA (but security keys alone will not work for this setup):

  1. Passkeys and security keys.
  2. A Google prompt to a device.
  3. Authenticator App
  4. Phone number

✅ 2-Step Verification turned on successfully

Note

ℹ️ You have the option to download and print the codes. You can also write them down or copy and paste them securely.

✅ Google backup codes saved successfully

Important

⚠️ Don't share these backup codes. Save them securely. Should you ever have trouble accessing your Google account these codes can be used to log in.

4. Create a Google App Password#

Go to: Google Account Homepage https://myaccount.google.com/

image
Note

ℹ️ To continue, you may need verify it’s you by logging in again

🔸 You should see

App passwords

image
🔸 You should see

Popup with: Generated app password

✅ App password created successfully

image
Troubleshoot

🛠️ If you've set up 2-Step Verification but can't find the option for app password, it might be because:

Important

⚠️ Google revokes your app passwords when you change your Google Account password. To continue to use this setup after changing your Google password, you'll need to repeat Step 4 and 5.

5. Configure BTCPay Server Email#

🔸 You should see

Password is Configured

✅ BTCPay email server is configured successfully

image

6. Send Test Email#

Scroll to Testing

🔸 You should see

“Email sent to [Gmail address]. Please verify you received it.”

✅ Test email sent successfully

image
Note

ℹ️ You’ve sent yourself a test email. A new message should appear in your inbox. Check your Sent folder to verify.

image

7. Set Up Email Rules for Automated Order Confirmations#

Scroll to Email Rules

Email Rules

✅ Automated order confirmation emails set up successfully

image#

🎉 Congratulations! Customers will now receive automated order confirmation emails! ⚡️#

8. Email Templates#

Let's shape how those emails look. Below are ready-to-use templates you can adapt for physical products, digital products, or event tickets.

Note

ℹ️ Only the body of the email varies. All emails can be customized with dynamic fields (e.g., order number, item, buyer name etc).

Paste the following into the Subject field:

Thank you for shopping with [YOUR STORE NAME] | Order #{Invoice.Metadata.orderId}

This will personalize each email subject line with the buyer’s order number.

Important

⚠️ Replace [YOUR STORE NAME] with your actual store name.

image

📦 Template 1: Physical Products That Require Shipping#

Body:

We’ve received your order and it’s now being processed.

Your Order:
Item: {Invoice.Metadata.itemDesc}
Total Price: {Invoice.Price} {Invoice.Currency}

Shipping To:
Name: {Invoice.Metadata.buyerName}
Email: {Invoice.Metadata.buyerEmail}
Address:
{Invoice.Metadata.buyerAddress1}
{Invoice.Metadata.buyerAddress2}
{Invoice.Metadata.buyerCity}, {Invoice.Metadata.buyerState} {Invoice.Metadata.buyerZip}
{Invoice.Metadata.buyerCountry}

Order Reference:
Order ID: {Invoice.Metadata.orderId}
Invoice ID: {Invoice.Id}

Thanks again for shopping with us!
[YOUR STORE NAME]
Important

⚠️ Replace [YOUR STORE NAME] with your actual store name.

Email example:

image#

💻 Template 2: Digital Products#

Body:

We’ve received your order and it’s being processed.

Your Order:
Item: {Invoice.Metadata.itemDesc}
Total Price: {Invoice.Price} {Invoice.Currency}
Delivery Details:
Name: {Invoice.Metadata.buyerName}
Email: {Invoice.Metadata.buyerEmail}

You’ll receive your item in a separate email.

Order Reference:
Order ID: {Invoice.Metadata.orderId}
Invoice ID: {Invoice.Id}

Thanks again for your order!
[YOUR STORE NAME]
Important

⚠️ Replace [YOUR STORE NAME] with your actual store name.

Email example: image

🎫 Template 3: Event Tickets#

Body:

We’ve received your order and your tickets are being prepared.

Your Order:
Event: {Invoice.Metadata.itemDesc}
Total Price: {Invoice.Price} {Invoice.Currency}

Ticket Holder:
Name: {Invoice.Metadata.buyerName}
Email: {Invoice.Metadata.buyerEmail}

Your tickets will be sent in another email. Please present them (printed or on your phone) for entry.

Order Reference:
Order ID: {Invoice.Metadata.orderId}
Invoice ID: {Invoice.Id}
Thanks again for your order & see you at the event!
[YOUR STORE NAME]
Important

⚠️ Replace [YOUR STORE NAME] with your actual store name.

Email example: image

9. Test Automation#

✅ Automated order confirmation emails sent successfully

Next Steps#

Heads Up#

✨ Big Thanks#

Shout out to the free, and open-source bitcoin projects and communities that make it possible to just do things:

BTCPay Server#

Bitcoin Aruba#

Cyphermunk House#

Without their work, tools in this guide wouldn’t exist. Support them, contribute if you can, and share what you build.

This is the second guide by FAFO Rocks to help merchants accept bitcoin payments with less friction. It’s part of a growing series that will keep evolving as we learn in practice, we aim to cover things like on-chain payments, conditional logic email automation, and more.

Part 1#

Connect with us to share feedback, suggest improvements, or follow along as new guides are released.

FAFO Rocks#

⚡️ Made Possible by Free, Open-Source Bitcoin Projects 🔥#

image

Thanks for reading! Keep stacking, keep learning, keep sharing, and keep building.

#BITCOIN#BTC#BTCPay#BTCPay Server#Bitcoin#Decentralization#Freedom#Lightning Network#Open Source#bitcoin#blogging#events#freedom#guide#lightning#merchants#products#services#zaps#{Invoice.Metadata.orderId}`

Written by

Just Tam

Comments

No comments yet. Start the conversation.

Contents

9 sections

  1. Keep in Mind
  2. What You’ll Need
  3. Decisions to Make
  4. Get Started
  7. 🎉 Congratulations! Customers will now receive automated order confirmation emails! ⚡️
  9. ✨ Big Thanks