Gateway Configuration

If you need an introduction to the purpose and function of Gateways and Merchant Accounts, or need help obtaining one, please see our FAQ on Payment Gateway Installations..

By default, your Site will be set to use the Chargify Test Gateway. The Test Gateway is great for playing around, but in order to test your integration with a sandbox gateway, or to sell subscriptions using a real gateway, you will need to choose a gateway and enter your credentials.

The Chargify Test Gateway

This gateway does not do any real authorizations or captures on credit cards. It allows you to simulate successful and unsuccessful credit card transactions.

When using the Chargify Test Gateway:

  • Use the credit card number “1” to simulate a credit card in good status. All payments and authorizations will succeed.
  • Use the credit card number “2” to simulate a credit card that will not accept any payments. Authorizations will succeed.
  • Use the credit card number “3” to simulate a credit card in which all authorizations and payments will fail.

Sites in test mode connect to “Sandbox” gateways

Any Site that is in test mode will only work with gateways accounts that are provided as test, developer, or sandbox accounts from your gateway provider. Usually, these “test” gateways use a different URL than their production counterparts, and Sites that are in test mode will only connect to these URLs.

Sites in production mode connect to “Live” gateways

Any Site that is in production mode will only work with real, live gateway accounts. If you are experiencing problems with incorrect credentials, ensure that you don’t have a mismatch between your Chargify Site mode (test vs. production) and your type of gateway (test vs. live)

Selecting or Changing your Payment Gateway

You may only change gateways if the Site has no payment profiles. If you need to change gateways, you may either delete all of the payment profiles within your Site, create another Site, or follow the Gateway Change Process. If you are working with a test site, you may also consider clearing your Site data for a quick way to “reset” your Site and change gateways.

Setting up or Changing your Payment Gateway

To set up your gateway and credentials, start by selecting the site you want to modify.

Next, click the Settings tab.


Click the blue button to “Connect with Stripe”,

Then authorize Chargify to access your Stripe account:

When Connecting with Stripe, if your site is in Test Mode, we will configure your site with test credentials. Once you complete the “Go Live” process, you will need to return to the Gateway Settings page, Disconnect and then Connect with Stripe again to get live credentials so that you can process real transactions.

Other Gateways

Click “Use this Gateway” next to the name of your gateway provider. Some providers may be disabled if they do not support the Site’s selected currency or if the site already has subscriptions.

And then enter your gateway credentials.

All fields are required. The credentials requested for your gateway should be provided by your gateway, either via email or in their administrative interface. Be sure that you are entering your test credentials for a test site or live credentials for a production site.