Import ACH data

When migrating ACH data from your previous processor, we can import the ACH records into Stripe using the default bank account (ba_) object or a payment method (pm_) object representation.

Before the first charge with ACH direct debit, a business must get permission from the customer to debit their bank account by presenting a mandate to the customer. To import ACH records as pm_ objects, we need your confirmation that you hold mandates for the bank accounts you’re importing. If you’re unsure, consult your previous payment service provider. If you don’t hold the mandates, we import the ACH records with the ba_ object representation.

After determining mandate status for all, some, or none of the bank accounts, inform us. Based on your response, we’ll then provide instructions on the next steps you need to take.

ACH validation status

You must confirm the WEB debit accounts’ validation status by choosing one of the options below:

• All WEB debit accounts were debited before the Nacha WEB Debit Account Validation Rule took effect on 19 March 2022.
• All WEB debit accounts have been validated according to Nacha’s Web Debit Account Validation rule by your previous payment service provider.
• Some WEB debit accounts were debited before Nacha’s WEB Debit Account Validation Rule became effective on 19 March 2022, or complied with the rule through your previous provider. You must provide a list of validated and non-validated records.
• None of the WEB debit accounts were processed before the effective date of the Nacha WEB Debit Account Validation Rule on 19 March 2022, nor successfully validated by your previous provider. Stripe must validate these accounts. (An instant verification fee applies per bank account validation.)

How it works

ACH emails

In our intake form, choose whether to import the mandates as bank account (ba_) or payment method (pm_) objects.

• If you choose bank accounts, we don’t notify your customers about the migration.
• If you choose payment methods and provide customer emails, we’ll automatically send your customers an email to confirm the mandate in accordance with Nacha requirements after the import. Your customers don’t need to do anything after receiving the emails.

ACH file guidance

• A processor can provide a number of different fields.
• We advise your processor to provide a full export of all customer and payment method data to Stripe.
• Stripe can filter out any unnecessary fields from the previous processor’s data as needed.
• Stripe can merge multiple received files if either the old customer ID or the old source ID is present in both files.

File formatting requirements

Export data files must meet the following data standards for us to proceed with an import:

• The file must be in CSV format.
• The file must be UTF-8 encoded.
• Delimit rows by a single newline character \n (not \r\n).
• Delimit columns by ,
• You must wrap all fields containing commas in double quotes ". We recommend wrapping all fields in double quotes.
• Leave empty fields entirely empty (no character in between delimiters). You must not denote a missing field with NULL, N/A, or any other value.
• Escape any double quotes that are part of the content with another double quote as per the CSV RFC. For example: "``William ""``Bard of Avon``"" Shakespeare``"
• Fields can’t contain newline characters (\r or \n) within a field. Example of what to avoid: 101 1st Ave\nApt 1
• All rows must have the same number of columns.
• Columns support any order.
• You must encrypt sensitive data files with our PGP key before submitting through SFTP.

ACH data fields