The mail-gateway addon must be installed and activated before you can send emails. See the addons page for installation instructions.
Configure SMTP settings
1
Navigate to Settings in the left sidebar, then click the Mail tab.
2
Fill in your SMTP credentials:
3
Click Save to persist your configuration. OwnPay tests the connection automatically.
Email templates
OwnPay ships with Twig-based email templates for common events. You can customize these from Settings > Mail > Templates.- payment_received
- refund_processed
- password_reset
Sent to the brand operator when a payment completes successfully. Contains the transaction ID, amount, currency, gateway used, and customer email.
All templates use the Twig templating engine. You can access transaction data, brand settings, and customer fields using dot-notation variables like
{{ transaction.amount }}.Test your email setup
After configuring SMTP, send a test email from Settings > Mail > Send Test Email. Enter a recipient address and click Send. Check the following:- The email arrives in the inbox (not spam)
- The sender address matches your configured From Address
- Template variables render correctly
Common issues
SPF/DKIM/DMARC failures
SPF/DKIM/DMARC failures
Email providers may reject or flag your messages if DNS authentication records are missing. Add an SPF record authorizing your SMTP host, a DKIM record for cryptographic signing, and a DMARC policy to your sending domain. Your email provider’s documentation covers the exact record values.
Gmail requires an App Password
Gmail requires an App Password
If you use Gmail as your SMTP provider, standard account passwords will not work. Go to your Google Account > Security > 2-Step Verification > App Passwords and generate a dedicated 16-character password for OwnPay.
Emails landing in spam
Emails landing in spam
Beyond SPF/DKIM/DMARC, ensure your From Address domain matches the SMTP host domain. Warm up new IP addresses gradually and avoid sending bulk emails through the same SMTP credentials used for transactional notifications.
Related Pages
- Addons - Install and manage the mail-gateway addon
- Telegram Notifications - Push notifications as an alternative channel
- Password Reset - Email-triggered password recovery flow