Documentation

Getting Started

1. Install from Stripe Marketplace

Visit the Stripe Marketplace and search for RouteReceipts, or click "Install on Stripe" from our website. Follow the prompts to authorize the app on your Stripe account.

2. Disable Stripe's Automatic Receipts

For RouteReceipts to work correctly, you need to turn off Stripe's built-in receipt emails. Go to Dashboard → Settings → Emails and disable "Successful payments" under the Receipts section. This prevents duplicate receipts from being sent.

3. Build Your Allowlist

Open RouteReceipts from your Stripe dashboard sidebar. Add customers who should receive receipts by entering their customer ID (cus_xxxxx) or email address. You can also add optional notes to each entry.

When you enter a customer ID, RouteReceipts automatically looks up the customer's email from Stripe and pre-fills it for you.

How Receipt Routing Works

When a customer pays an invoice, Stripe fires a webhook event. RouteReceipts receives this event and checks the customer against your allowlist:

• On the list: RouteReceipts sets the charge's receipt_email field, which triggers Stripe to send the receipt to that customer.
• Not on the list: The receipt is suppressed. No email is sent.

Every decision is logged with the event ID, customer, and reason. You can view recent decisions in the RouteReceipts settings page.

Managing Your Allowlist

Adding Entries

Click RouteReceipts in your Stripe dashboard sidebar to open the allowlist manager. Enter a customer ID, email, or both, along with an optional note, then click "Add to Allowlist."

Customers can be matched by either customer ID or email address. If a customer has both fields set in the allowlist, either match will trigger receipt delivery.

Searching

Use the search bar to filter your allowlist by customer ID, email, or notes. This is helpful when managing a large number of entries.

Removing Entries

Click the delete button next to any entry to remove it from the allowlist. That customer will no longer receive receipts for future invoices.

Billing and Plans

Upgrading

Go to RouteReceipts settings in your Stripe dashboard (Settings → Installed apps → RouteReceipts). Click the upgrade button for your desired plan. You'll be directed to a Stripe Checkout page to complete payment.

Managing Your Subscription

From the settings page, click "Manage billing" to open the Stripe billing portal. From there you can update your payment method, switch plans, or cancel.

Usage Limits

Your current usage is displayed in both the sidebar and settings views. When you reach your monthly limit, a banner appears and receipt delivery pauses until your next billing period or you upgrade.

Troubleshooting

Customers are receiving duplicate receipts

Make sure you've disabled Stripe's automatic receipt emails in Settings → Emails. If both Stripe's built-in receipts and RouteReceipts are active, allowlisted customers will receive two copies.

A customer on my allowlist didn't receive a receipt

Check the decision log in RouteReceipts settings. Possible reasons include:

• Monthly receipt limit was reached at the time of the event
• The customer ID or email in the allowlist doesn't match the invoice's customer
• The invoice event was processed before the customer was added to the allowlist

The sidebar shows "Monthly limit reached"

You've used all receipts for the current billing period. Upgrade to a higher plan in settings, or wait for the next billing period to resume.

Support

Need help? Email us at support@routereceipts.app.