RevCent KB

Live Mode vs. Test Mode

How and why to use Live or Test mode within RevCent

RevCent allows you to toggle between live and test mode. This gives you the ability to run test transactions and create test sales before going to production. When you are ready for production you simply switch to live mode.

In the web app, you toggle between modes by clicking the mode button in the top navigation. By toggling modes in the app, you will only see entities related to the specific mode that is activated. This helps to separate live and test entities (sales, transactions, etc.) from being viewed simultaneously in the web app.

There are some important concepts involved when using either mode, including setting the appropriate gateway credentials and using the appropriate RevCent API Account and RevCent Payment Profile.

Payments

Depending on the payment type used to create a sale, live or test modes may have different requirements or may not be available.

Credit Card

RevCent will send transactions to a payment gateways’ live or test endpoint depending on the integration mode. It is important that you use the proper credentials when creating a gateway as some gateways have different credentials for live and test modes. RevCent will automatically route the transaction to either the gateways’ live or test endpoint based on the integration mode.

Gateway Credentials

If you plan on running test transactions before switching to production, we recommend creating two RevCent Gateways for the same payment gateway. One you will set up with live credentials and the other with test credentials. This enables you to easily switch gateways in your integrations when ready for production.

Live/Test Example:

  • Live Credentials: Create a RevCent Gateway using the payment gateways’ live credentials.
  • Test Credentials: Create a RevCent Gateway using the payment gateways’ test credentials.

Payment Profile

When creating a RevCent Payment Profile make sure that the payment profile is using live or test gateway(s), not both. A payment profile does not have a live or test mode, instead it relies on the integration mode to determine what payment gateway endpoint to use.

Check & Offline

Check and offline payments have the ability to utilize the live/test mode scheme. Sales processed via check or offline payments will spawn either live or test entities depending on the integration mode.

PayPal

All PayPal payments and disputes are in live mode only. At this time it is not possible to create a sale using PayPal in test mode. All PayPal transactions are processed using live PayPal credentials.

Integrations & Modes

The determination of live or test mode, and proper payment routing, is made via the integration used and either the integrations’ setting or API account.

RevCent Web App

The web app mode you are browsing in determines either live or test mode.

If you are using the RevCent Web App and wish to create a live sale, you must be browsing in live mode. The same rule applies to test mode. Toggle between modes by clicking the mode button on the top of the navigation.

Live/Test Example:

  • Live Mode: When creating a sale within the web app you select a RevCent Gateway that has been set up with live credentials or select a RevCent Payment Profile that contains gateways using live gateway credentials.
  • Test Mode: When creating a sale within the web app you select a RevCent Gateway that has been set up with test credentials or select a RevCent Payment Profile that contains gateways using test gateway credentials.

Setting Modes:

  • Live Mode: Click the mode button in the top navigation and select live mode.
  • Test Mode: Click the mode button in the top navigation and select test mode.

RevCent API

The RevCent API Account mode setting determines either live or test mode.

If you are using the API and wish to create a live sale, you must use a RevCent API Account that is set to live mode. At the same time, in the API call you must specify a RevCent Gateway that has been set up with live credentials or specify a RevCent Payment Profile that contains gateways using live gateway credentials.

Live/Test Example:

  • Live API Account: When creating a sale, RevCent will automatically send transactions to your gateway’s live endpoint. Make sure within the API call you specify a RevCent Gateway using live credentials or a RevCent Payment Profile that contains gateways using live credentials.
  • Test API Account: When creating a sale, RevCent will automatically send transactions to your gateway’s test endpoint. Make sure within the API call you specify a RevCent Gateway using test credentials or a RevCent Payment Profile that contains gateways using test credentials.

Setting Modes:

RevCent Hosted Page

The hosted pages’ mode setting determines either live or test mode.

If you are using a RevCent Hosted Page and wish to create a live sale, you must set the hosted page to live mode and the RevCent Payment Profile selected to process payments for the shop must also contain gateways that are set up using live gateway credentials. The same rules apply to test mode.

Live/Test Example:

  • Live Mode: When processing a hosted page sale, RevCent will process payments and create sales as live entities.
  • Test Mode: When processing a hosted page sale, RevCent will process payments and create sales as test entities.

Setting Modes:

  • Live Mode: Create or edit a Hosted Page and select live mode. Also, set the hosted pages’ associated RevCent Payment Profile to one that contains gateways using live gateway credentials.
  • Test Mode: Create or edit a Hosted Page and select test mode. Also, set the hosted pages’ associated RevCent Payment Profile to one that contains gateways using test gateway credentials.

WooCommerce

The RevCent API Account mode setting associated with the WooCommerce Shop determines either live or test mode

If you are using a WooCommerce Shop and wish to create a live sale, the RevCent API Account associated with the WooCommerce shop must be in live mode and the RevCent Payment Profile associated with the WooCommerce shop must also contain gateways that are set up using live gateway credentials. The same rules apply to test mode.

Live/Test Example:

  • Live API Account & Live Payment Profile: When processing a WooCommerce sale, RevCent will process payments and create sales as live entities.
  • Test API Account & Test Payment Profile: When processing a WooCommerce sale, RevCent will process payments and create sales as test entities.

Setting Modes:

  • Live Mode: Create or edit a WooCommerce Shop and set the associated RevCent Payment Profile to one that contains gateways using live gateway credentials. Also, edit the RevCent API Account that is associated with the shop and set it to live mode.
  • Test Mode: Create or edit a WooCommerce Shop and set the associated RevCent Payment Profile to one that contains gateways using test gateway credentials. Also, edit the RevCent API Account that is associated with the shop and set it to test mode.