If you want to alert your customers when their subscription payments fail, see Email Notifications instead.

We can send email receipts to your customers for every transaction or refund that you successfully submit for settlement. In order to use this feature, you must enable email receipts in the Control Panel and include an email address in the customer information for all transactions created both in the Control Panel or via the API.

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

If you want to customize the delivery or content of your receipts, it’s best to create and send your own. Alternatively, the next section covers how to enable Braintree’s email receipts, which do not require changes to your integration.

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 send an email to our Support team, requesting that this feature be activated

After you’ve received confirmation from our Support team, you must 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 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

    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 on your outbound emails
  • BCC: This allows you to send copies of all receipts to yourself (e.g.; the address will not be shown to customers
  • Email Text: The 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.

Subject: Transaction receipt

Here’s where your custom text goes.

--Transaction Information--
Merchant: Your Company Name
Amount: $150.00 USD
Transaction Date: Jul 18 2013, 10:37 AM CDT
Tax Amount: $1.00 USD
Tax Exempt: no
Purchase Order Number:12345678901234567
Order ID: 8675309
Authorization Code: PQH9HP
Status: Authorized

--Payment Information--
Payment Type: Visa
Cardholder Name: M.T. Schaunke
Credit Card Ends With:1111

--Customer Information--
Name: M.T. Schaunke
Company: Braintree
Phone: 312-555-1234
Billing Address: M.T. Schaunke
123 Main St
Suite 1
Chicago, Illinois 60654
United States of America
Shipping Address: M.T. Schaunke
456 1st St
Suite 2
Chicago, Illinois 60622
United States of America

Sending an email receipt manually

You can email or print a receipt by clicking Receipt on the Transaction Detail 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.

If you create your own custom receipts, you should never display the following information on a customer receipt:

  • Any more than the last 5 digits of the credit card number
  • The card's expiration date

Still have questions?

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

← Back to Previous Page