Stripe Integration
This document details how to connect the Stripe payment gateway to accept payments and how our integration works.
Capabilities
The Stripe payment gateway on Invoiced supports the following features:
Capability | Supported |
---|---|
Credit card payments | ✓ |
ACH payments | ✓ |
Vaulting cards | ✓ |
Vaulting bank accounts | ✓ |
AutoPay | ✓ |
Level 3 Processing | — |
Apple Pay | ✓ |
Multi-currency | ✓ |
Refunds | ✓ |
Setup
Connecting Stripe is a straightforward process. Follow these steps to start accepting payments through Stripe in minutes. These steps assume you already have a Stripe account. If not, then you can sign up for one at stripe.com.
-
From the Invoiced dashboard go to Settings → Payments.
-
Click Setup on the payment method you want to accept.
-
Click Connect Payment Gateway.
-
Select Stripe as the payment gateway.
-
Click Connect With Stripe. You will be taken to Stripe's website where you can sign into your Stripe account and grant Invoiced access.
-
After you've connected your Stripe account then the payment method you selected should be enabled.
-
If you are accepting ACH payments then you also need to accept the Stripe ACH Terms of Service.
Please make sure you are first signed into your Stripe account in order to accept the ToS.
Client Workflow
Credit Cards
Paying with credit or debit card is fairly straightforward for customers. They simply enter in their cardholder information and click Pay. We give receipts to your customers after a successful payment.
ACH
When a customer decides to pay with ACH they must first connect a bank account and verify it. The verification process depends on where they bank.
NOTE: Your Stripe account might have a dollar limit for individual ACH transactions, i.e. customers cannot submit payments greater than $2,000. We recommend checking with Stripe support to confirm if there are any ACH limits for your account and if it needs to be raised to accommodate the size of your transactions. This should be done before you allow customers to pay with ACH.
Instant Verification
We support instant verification for select banks, like Chase and Wells Fargo. Instant verification works by asking your customer to securely sign into their online banking account to prove access. Once they sign in they will be able to select the account they want to pay with, all without ever having to enter a bank account and routing number.
Manual Verification
All other bank accounts that do not support instant verification will require manual verification, also known as micro-deposit verification. The manual verification process makes two small, random deposits to your customer's bank account. We will then ask your customer to confirm the deposit amounts to prove ownership of the account. It generally takes 2 business days for the deposits to appear on the customer's bank statement.
Paying with ACH
Once a bank account has been verified then your customer can now use it to pay any invoice from you by returning to the invoice payment page and selecting their bank account as the payment method.
New ACH payments will have a pending status. ACH payments generally take 3-5 business days to complete. Once the transaction succeeds or fails we will update the invoice and send the customer a receipt. In the event of a failure we will create an event in the dashboard.
Subsequent payments will not require the customer to go through the verification process again.
Withdrawing Money
You just received your first payment through Stripe. Congrats! Now what?
Stripe sweeps successful payments to your bank account automatically on a daily basis. Once you have received your first payment with Stripe the first payout generally takes 7 business days. After that your payouts will happen on a 2-day or 7-day rolling basis depending on your account. You can learn more in Stripe's payout docs.
ACH Payment Settlement
ACH payments are not instant like credit card payments. An ACH payment will be marked as pending until the transaction has cleared. An ACH payment is not considered paid until the transaction has cleared.
ACH payments take up to 5 business days to receive acknowledgment of their success or failure. Because of this, ACH payments take up to 7 business days to be reflected in your available Stripe balance. You can learn more from Stripe's ACH docs.
Importing Customers from Stripe
In this section we will show you how to import customers and payment information from Stripe into Invoiced. The process is very straightforward and does not require that you handle or send us any sensitive payment information.
-
Go to the Customers page and click on the Import button in the top-right.
-
Click on Stripe.
-
Click Start to begin the import.
-
The import will begin. You can go elsewhere while you wait. If there is a large # of customers being imported then this could take several minutes.
-
Invoiced will send you an email when the import is done. When the import is finished all of your imported customers should be visible in the Customers page.
Support
Need help with your Stripe account? You can get help from Stripe's support website or contact Stripe directly.