Gateway Setup Wizard

After installing the Chargent packages and assigning licenses and permissions to your users, you must configure your payment gateway. If you don’t have a payment gateway yet, please contact us; we are happy to help you determine which gateway will best suit your needs.

If you know what gateway you’ll be using, check out our Payment Gateway Guides for information and instructions specific to your gateway.

Before You Begin #

You will need the following information handy to configure your gateway:

• API Login ID from your selected gateway
• Transaction Key from your selected gateway
• Determine if you plan to use tokenization
• Determine what currency you will be using
• Determine if you plan to use the Payment Console
• Decide what payment methods you plan to accept
• If you plan to process Bank Account transactions, choose the Direct Debit Network for your region so that the correct direct debit network fields display on your payment requests and payment console. Bank Account transactions may also be referred to as E-Check or electronic check transactions.
• Determine if you want to process recurring, scheduled, or installment payments
• Determine when you want Chargent to run the batch (3 AM is recommended as the default)
• Add the Gateways tab to your nav bar by clicking the pencil icon at the top right of your tabs

Note: Depending on your gateway, your screen may appear different than the samples displayed in this topic. Click here for individual gateway guides.

Using the Gateway Setup Wizard #

To access the Setup Wizard and create your Gateway record:

1. Go to the App Launcher and click the Chargent app.
2. Click the Chargent Settings tab.
3. Click the Setup Wizard subtab.
4. When prompted, “Do you have a Payment Gateway account?” click Yes.
5. Select your payment gateway from the list and click Continue.
6. Add your gateway account credentials and select whether or not this gateway will be processing test or live transactions. We recommend initially creating a test gateway record with test credentials until you have successfully completed any required test transactions.

Important: Make sure to select the Test Transactions or Live Transactions tab based on whether or not you are using a test or live gateway account.

7. Click Sign In. When you receive a message stating “Your credentials have been successfully verified!”, click Continue to complete the steps in the wizard. If you receive an error message in red, see our troubleshooting tips.

8. Will you use tokenization? If you click yes, the Use Tokenization field will be checked, and the Credit Card / Bank Account Data Handling field will be set to “Clear When Token Present”. (recommended)
9. What currencies will be available when using this gateway record? (USD, CAD, etc.)

Note: Ensure that your payment gateway supports your chosen currencies before making a selection.

9. Do you want to enable Payment Console? Payment Console is a premium feature of Chargent and is included in Platform and Enterprise Editions of Chargent.
   • Click Yes to request a Chargent Activation Key for Payment Console.
   • Click No if you don’t require Payment Console or have already added a Chargent Activation Key to your org.
10. What payment methods will you be accepting?
    • Will you accept credit cards? If so, what credit Card types will you be accepting? (Visa, Mastercard, etc.)
    • Will you accept Bank Account payments? If so, what Direct Debit Network will you use? You can choose any of the following Direct Debit Networks supported by your gateway and based on your location:
      • ACH – US
      • EFT (ACSS) – Canada
      • BECS – Australia
      • SEPA – Europe
    • Will you be using ACH Validation? (Not all gateways support ACH Validation)

11. Set up your Payment Console (this page only displays if you click Yes on step 9).
    • Will you show the Charge, Create/Update Token, or Authorize buttons?
12. Will you be using recurring, scheduled, or installment payments?
    • If you click Yes, the Setup Wizard will continue and assist you with creating a Recurring Billing Batch.
    • Click No if you’ve already created a Recurring Billing Batch or will not be taking recurring payments.
13. If you click Yes in step 12, you will be asked if you want it to run the batch at 3 am (recommended) or a different time. If you choose not to run the batch at 3 am, you will be given the option to choose when to run the batch.

14. Click Start Recurring Batch to create the Recurring Billing Batch.
15. The final step, “Credit Card Surcharging,” will allow customers with a supported gateway to enable surcharging for credit card payments.
    • Visit Setting Up Surcharging to learn more about this feature and the gateways supported. If your gateway is not supported or you don’t wish to enable surcharging, simply leave the feature deactivated and click Continue.

Congratulations! You successfully configured your payment gateway. Regardless of whether or not this is your first time configuring a gateway in Chargent, we recommend testing your gateway before processing any live transactions. You’ll need test credentials for your gateway that you’ll use when processing test transactions. When all testing is complete, set up your live gateway with live gateway credentials to process all transactions.

Troubleshooting #

Gateway Credential Error

If you receive an error message stating, “Credentials you provided are not valid. Please check and try again.”

This error can be caused by one or more of the following:

• Your gateway credentials are either invalid or expired. Please check them and try again.
• You are using test credentials to set up a live gateway.
• You are using live credentials to set up a test gateway.
• The Remote Site Settings for your payment gateway are not active.

For troubleshooting instructions, review Error: The Credentials you provided are not valid. Please check and try again.

Surcharging Credential Error

Customers enabling surcharging may encounter an error, “The API Token entered was unable to successfully connect to InterPayments. Please check your value and try again.”

This error can be caused by one or more of the following:

• Your InterPayments credentials are invalid, or you haven’t created an InterPayments account.
• You are using test credentials for live surcharging.
• You are using live credentials for test surcharging.
• The Remote Site Settings for InterPayments are not active.

Learn more about resolving this error by visiting Surcharging Error: The API Token entered was unable to successfully connect to InterPayments. Please check your value and try again.

See Also

Gateway Setup and Resources
Supported Payment Gateways
Gateway-Specific Setup Guides
Recurring Billing Batch