note

For information about how to alert customers when subscription payments fail, see our article on email notifications instead.

Your Braintree gateway can be configured to send email receipts to your customers for every transaction or refund that you successfully submit for settlement.

To use this feature, you must:

Braintree's email receipts can include a line of custom text, but can't otherwise be altered. If you want to customize the delivery or content of your receipts, it’s best to create and send your own.

PayPal email receipts

PayPal sends receipts to its customers for PayPal transactions by default. If you are using Braintree’s email receipts, PayPal customers will receive two receipts: one from Braintree and one from PayPal.

Enabling email receipts

Before you can enable this feature, you must:

  1. Configure your SPF records to give us permission to send receipts on your behalf
  2. Have the authorized signer on your account contact our Support team, requesting that this feature be activated

After you’ve received confirmation from our Support team, enable email receipts in the Control Panel:

  1. Log into the Control Panel
  2. Navigate to Settings > Processing > Email Receipts
  3. Click Options
  4. Check the box next to Enabled
  5. Configure your settings
  6. Click Save

Configuration options

On the Edit Receipt Options page where you enabled this feature, you can also personalize the email receipts for your business:

  • Send Receipt by Default?: With this box checked, receipts will be sent to customers for every successful transaction
important

If you choose to enable this option, you will need to either specify an email address when creating each transaction or ensure each customer in your Vault has an associated email address. Transactions submitted for customers that do not have an email address will trigger a validation error.

  • Sender Email Address: This is the address customers will see in the From: field of your outbound emails
  • BCC: This allows you to send copies of all receipts to yourself (e.g. receipt-archive@mydomain.com); this email address will not be visible to customers
  • Email Text: Custom plain text that will appear at the top of every receipt, limited to a maximum of 1000 characters

Sample email receipt

All possible transaction fields are shown in the sample below. If you are not utilizing some of these fields (e.g. Order ID), they will not appear on your customers’ receipts. Custom fields will not appear on receipts, either.

Sending an email receipt manually

If you need to manually generate a receipt for a transaction, you can do so on the Transaction Details page. You'll find a Receipt button at the top of that page.

If you collected the customer's email address during the transaction, the address will populate automatically.

Sending your own email receipts

In order to send your own custom email receipts, you’ll need to work with your developers to set up custom logic on your end.

To generate a useful receipt, you’ll need to retrieve the transaction details from the result object via the API. For recurring billing transactions, you’ll need to search for the transaction details. Once you have this information, use your custom logic to generate and distribute the receipt.

important

If you create your own custom receipts, you should never display the card's expiration date or any more than the last 5 digits of the credit card number.

Still have questions?

If you can’t find an answer, contact our Support team.


← Back to Previous Page