Getting Started

Building Blocks

Subscription Features

Localization

Invoices

Credits

Billing Features

Taxes

Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages

Attach Additional Data

Migration

Open Source Resources

Other Features

API Integration

Third Party Integrations

Stripe 

Stripe  is a payment solution which lets you accept payments online. It is a full stack solution which replaces the need to have a payment gateway or a merchant account separately. Stripe processes your payments (acting as a payment gateway) and also deposits the funds in your bank account (acting as a merchant account). It cannot be used with your existing payment gateway or merchant account.

Choosing Stripe 

The following criteria can be considered before choosing Stripe as a payment solution.

  • Countries supported: Stripe is available in countries like United States, Australia, Canada, United Kingdom and Ireland. Stripe is also available in beta and private beta in some countries. 
    Find the complete list here 

  • Business Type: Before activating your account, Stripe requests you to furnish details about your business and the products/service you intend to sell. Stripe does not support these prohibited businesses 

  • Payment Methods: With Stripe, you can charge almost any kind of credit or debit card. U.S. businesses can accept Visa, MasterCard, American Express, JCB, Discover and Diners Club. Australian, Canadian, and European businesses can accept Visa, MasterCard and American Express.

  • Pricing: Stripe does not have setup fees or monthly charges. The rates are transaction based which depend on the country of your Stripe account and the currency you use. More details about pricing here 

  • Data Portability: Stripe supports data portability . If you decide to switch between payment providers, Stripe lets you do so by exporting the card information of your customers into a PCI compliant vault.

  • Currency Support: The currencies Stripe supports depend on where your business is located. Here's a list of currencies supported by Stripe 

Stripe modes 

Every Stripe account has two modes : A test mode and a live mode.

Stripe's test mode is similar to the live mode and has all its features. However, you cannot accept real payments from customers using the test mode.

In the test mode, you can simulate transactions using test cards. Test card numbers are provided in later sections. Testing will help you simulate a real time payment scenario. It is advisable to carry out test transactions before carrying out live transactions.

To switch from the test to live mode, you will have to activate your account . This requires you to furnish basic information about your business, your bank account etc.

Integration options 

Chargebee supports integrating with your Stripe account's test as well as live modes. The mapping is as follows:

Chargebee Test Site - Stripe Account (test mode)
Chargebee Live Site - Stripe Account (live mode)

This essentially means that Chargebee automatically takes care of connecting to the appropriate Stripe mode based on your Chargebee site's type.

Chargebee offers the following options to integrate with Stripe.

Option A Chargebee's hosted payment pages + Stripe Gateway

In this method the card information of the customers are collected by Chargebee's secure hosted pages and directly passed on to Stripe.

PCI Compliance Requirements: Low

Your PCI compliance requirements are greatly reduced because of Chargebee's hosted pages. As a merchant using Chargebee's hosted pages, all you have to do is submit a Self Assessment Questionnaire (SAQ-A)  to stay compliant.

Option B Chargebee's API + Stripe Gateway

In this method, collecting card information will have to be handled at your end and has to be passed on to Chargebee. Chargebee then routes this card information directly to Stripe.

PCI Compliance Requirements: High

As a merchant, since you will be collecting card information directly, you will have to take care of PCI Compliance requirements.

Option C Chargebee's API + Stripe js

In this method, Stripe gives you a payment form which can be embedded in your checkout page. This way, your PCI requirements are reduced. The card information collected via the payment form is directly sent to Stripe.

Checkout these tutorials which would help you in setting up Stripe js with Chargebee.

Refer here for further information.

PCI Compliance Requirements: Low

As the card details are collected by Stripe, your PCI compliance requirements are reduced. If you are using the latest version of Stripe js,  you will have to submit a Self Assessment Questionnaire (SAQ-A)  to stay PCI compliant. Read more here 

Connecting your Stripe account to Chargebee 

Chargebee makes use of Stripe Connect  to safely connect to your Stripe account directly. This way, you will be redirected to Stripe's login page where you will have to authenticate your Stripe account by entering your login details.

If you do not have a Stripe account, Chargebee also gives you the option to create a new account.

To add Stripe to your site, go to SettingsGateway Settings and click on Configure a Payment Gateway. You will now see a list of Payment Gateways.

From the list, select Stripe and click on Use this Gateway.

"

Once you are on the Stripe Gateway page in Chargebee, you will have an option to either create a new Stripe Account or Connect to an Existing Account as shown below.

"

Instructions for connecting your Stripe Account to Chargebee in both the cases are discussed below.

1. Create a new Stripe Account

Selecting this takes you to Stripe and gives you an option to create a new account by configuring details about your business, your Social Security Number etc.

"

2. Connect to an Existing Account

Selecting this takes you to the Stripe Login Page where, by logging into your account, your Stripe account is connected to Chargebee.

"

After you select Sign in with Stripe to connect, you will be redirected to the Stripe Login Page.

"

Once you login with your Stripe credentials, you will be redirected to Chargebee with your Stripe account automatically connected.

"

Reconnecting to your Stripe account
An option to Reconnect your Stripe account is also provided once you integrate your Stripe account. In event of any transaction failures with the message "access denied by gateway", make use of the Reconnect option to re-establish a connection.

Information

Ensure you do not revoke Chargebee's access to your Stripe account. In such an event, use the Reconnect option to re-establish a connection.

Other Configurations

Additionally, you can choose whether to retain card information (if you have more than one gateway working simultaneously), configure supported card types and disallow prepaid cards as a payment method on the configuration page.

"

Configuring Webhooks 

Stripe uses webhooks to notify your site of events related to your Stripe account.

Once the Notification URL provided by Chargebee is configured in Stripe, Chargebee would receive notifications of all events in Stripe.

To configure the webhook, in your Chargebee web interface, go to SettingsSite SettingsGateway SettingsStripe - Gateway Configuration page and copy the Notification URL.

"

Now in your Stripe account, go to Your AccountAccount SettingsWebhooksAdd endpointAccount, paste the notification URL given in your gateway details page, and select the mode based on your Chargebee site (Live site → Live mode/Test site → Test mode).

"

Chargebee will listen for Card Update events. Stripe works directly with card networks and updates the card automatically so that a customer's card would work even if their physical card is replaced by the bank. You can enable this feature by adding the Notification URL that Chargebee provides in your Stripe account's webhook settings page.

Additional Configurations in your Stripe account 

In your Stripe account under Account SettingsGeneral ensure that you configure the following settings which will help in reducing transaction failures or fraudulent transactions:

  • Charges that fail CVC verification

    CVC numbers are important for authenticating card-not-present transactions.

  • Charges that fail zip code verification

    Zip code is verified as part of AVS checks. AVS is a service that cross verifies the billing address entered by the customer against the address available with the credit card company. It is a security check which helps in combating fraudulent transactions that, if unnoticed, could result in chargebacks. More on AVS here 

Information

If the above options are enabled, ensure the CVC code and zip code are collected mandatorily as part of the billing information.

Currencies supported 

Stripe and Chargebee support 100+ different currencies for charging customers across different geographical locations. If you intend to use Stripe+Chargebee for your business, ensure that your transactional currencies are supported by both. Find the complete list of currencies supported by:

Test Card Numbers 

The card numbers provided here can be used for testing card transactions in Chargebee's Test site in the test mode of your Stripe account.

While testing, use any number for CVV and a valid future date for the expiry date.

Card Number

Card Type

Response Description

4242 4242 4242 4242

Visa

Successful Transaction.

4000 0000 0000 0002

Visa

Attempts to charge will be declined with a Card Declined error.

4000 0000 0000 0341

Visa

Card can be added but attempts to charge will fail.

4000 0000 0000 0069

Visa

Charge will be declined with an "Expired Card" error.

Loading…