Table of Contents

  • [Select a gateway][#select-a-gateway]
  • [Configure Gateway Settings][#gateway-settings]
  • [Set Security Settings][#payment-security-settings]


A gateway is a company that’s used as a middleman to capture payments from your customer before being deposited in your bank. For more information on Payment Gateways click here.

The Payments settings is where you will configure your payment gateway, and get information about your gateway that may be used for advanced operations.

Select a Gateway

There are 2 dropdowns. One is for setting the primary gateway to be used in transactions. If no gateway is specified, this is the gateway that will be used.

The second dropdown is used to select a gateway to configure. You can select multiple gateways and configure them before submitting your changes to be saved.

Gateway Settings

Each gateway has different settings specific to the gateway. These settings are documented individually. The only common setting is the HTML Template. Each gateway can automatically output all of its required HTML in the checkout form. If you would like to override the default HTML and choose your own template, you can set that template here. Beneath the gateway settings, you can find a sample of the HTML that is output in the checkout form to use as a basis for creating your own template.

Payment Security Settings

It’s best to allow as little possibility for someone to exploit your system as you can. This section does a few important things.

  1. Allow Gateway Selection in Checkout Form

If you want your customer to be able to choose gateways, then this should be set to “Yes”. You might want to do this if you plan to take Credit Cards with and PayPal as well. If that’s the case, use the gateway_select tag in the checkout form. This will output a select box containing all available gateways to choose from.

  1. When gateway selection is allowed, selection is limited to checked gateways.

If you set the above setting to “yes” any checked gateways will be selectable by the customer using the gateway select tag.

  1. Validate Credit Card Number

If you are capturing credit card number, CartThrob can do a Luhn Check (Modulus 10 check) on the credit card before sending it on to your gateway. All gateways do this check, as well as additional checks, so this may not be needed.