Stripe Integration

To connect a payment processor to your account, you need to go to your Settings > Integrations area within your dashboard.

Connecting your Stripe account with ThriveCart is as simple as clicking the button within your account, logging into your Stripe account and authorising your connection.

We’re a Stripe Connect platform, meaning you do not need to manually create or provide API keys, set up webooks, etc. Simple connect your account as above and the integration is complete.

What payment methods are supported?

A Stripe integration, typically offers support for debit/credit card payment processing from your checkout pages. Whilst Stripe offer many different payment methods platforms and developers can opt to integrate with, we currently support the above methods.

If there is a specific payment method you would like ThriveCart to consider supporting via Stripe, you can submit a feature request here for future consideration.

Common Stripe Questions

We have a number of frequently asked questions around our Stripe integration and you can find these below:

  1. How are subscriptions handled within Stripe?
  2. Why are my subscriptions showing as ‘trialling’ or ‘in trial’ when I’ve not set a trial on my product?
  3. Why is there a $1 charge showing for a free trial?
  4. What are ‘incomplete’ payments in my Stripe account?
  5. Why do I have an ‘uncaptured’ charge in Stripe?

1. How are subscriptions handled within Stripe?

You can find our helpdesk article on subscription payments and how they’re created/work with different processors here.

2. Why are my subscriptions showing as ‘trialling’ or ‘in trial’ when I’ve not set a trial on my product?

This is completely normal and your subscriptions will show as trialling until the first recurring payment is due. There will be an invoice for the initial amount showing as zero for the subscription under the customers profile in Stripe.

The first payment of a subscription is charged as a ‘payment’ under the customer’s profile.

This is done for a number of reasons, including the ability to allow certain functionality in your account around specific charging.

3. Why is there a $1 charge showing for a free trial?

If you have a free trial on a product, you may notice a $1 uncaptured charge showing in your Stripe dashboard and the customer may question why they have been charged $1.

This isn’t a ‘charge’ but rather an authorisation check Stripe can sometimes complete if a free authorisation check fails. The $1 authorisation is automatically released after several days by Stripe.

They do this so that the card has a higher success rate for recurring payments to be processed and allow for things like 2-factor authentication from customers (such as in the EU) where needed.

You can find Stripe own help article on this here.

If you find you’re getting any questions from customers for your free trials around this, you could always include a note on your success page or in your receipt.

4. What are ‘incomplete’ payments in my Stripe account?

You may notice an ‘incomplete’ payment tracked into your Stripe account and when looking at the details, their logs will state that the payment information is missing.

This is normal and can occur when a customer enters their personal information on your checkout page and then clicks the ‘complete order’ button without entering their payment details in full (or if they apply a coupon that makes the product free).

If the customer tries to purchase again after updating their payment information – this record in Stripe will get updated automatically.

5. Why do I have an ‘uncaptured’ charge in Stripe?

If you’re looking at the ‘all payments’ area in your Stripe account, you may see a recent ‘uncaptured’ charge – again this is completely normal and these get populated in Stripe whilst your customer is going through your funnel.

Each time the customer agrees to buy a product in your funnel, Stripe will check their card and put a temporary hold/authorisation on the funds. These show as ‘uncaptured’ and then are automatically captured when the customers order completes.

Orders complete when:

  • The customer reaches the end of your funnel (success page)
  • If the customer quits your funnel on an upsell page, then ~10-minutes later the order completes and charges for anything they’ve agreed to buy will be processed (we have this small delay in case the customer accidentally closed the browser/went to another site and can come back to the upsell/checkout without the risk of paying twice)
  • If the customer sits on an upsell page without making a decision, they have 60-minutes before the system will push them through to the success page and complete their order.

For the 3rd point above, the 60-minute delay resets on each upsell page, so for example a customer could agree to buy your product, land on upsell 1 and spend 45 minutes going through your offer before making a decision, then on upsell 2 spend another 30 minutes making a decision. In this scenario, an uncaptured charge would be showing for over an hour.

Uncaptured charges that fall outside of this are exceptionally rare and usually point to 2-Factor Authorisation not being completed when required by the customer (some banks require their customers to confirm payments for anti-fraud). This is common in the EU where PSD2/SCA regulations are in force (something ThriveCart fully supports with Stripe).

An uncaptured charge could also remain if your funnel (using custom upsell pages) isn’t set up correctly.

If you have an uncaptured charge showing after several hours, then reach out to us directly in support. Please be sure to include a full screenshot of the payment page in Stripe and a copy/paste of the payment intent ID (shown at the top-right of the page as pi_xxx).

We do not recommend manually capturing charges.

These customers would not have seen a success page or received confirmation of their order so will not typically be expecting the charge to go through. Stripe automatically releases uncaptured charges after several days.

Updated on June 1, 2021

Was this article helpful?

Related Articles

Can't find the answer?
Can't find the answer to your question after searching the helpdesk and our extensive content? Click below to submit a ticket and get in touch with us.
Submit A Ticket