Knowledge Base

Payment gateways configuration

Last Modified:
24 Feb 2020
User Level:


To configure the Payment Gateways that you want to use with Form Builder, go to System Administration > System Settings > Payment Gateways. Before configuring a Payment Gateway, the connection with Form Bank server will need to be configured.

Set up a Payment Gateway 

If you are an Administrator and you want to process online payments with your forms, then the Payment Gateway must be configured in System Administration > System Settings > Payment Gateways.

For Administrators, there are two types of gateway available:


  • this is a test Payment Gateway that simulates how the form will work, this will not charge a card or accept any information

Screenshot of the TERMINALFOUR payment provider options

  • the "Required Provider Fields" are mandatory:
    • Currency: the default currency that payments will be processed with  
    • Account Number and API Key fields will accept any string
  • this should not be used in a production environment


To adhere to Strong Customer Authentication regulations the Stripe API has changed. Changes to payment gateway set-up and Form Builder are reflected in Terminalfour version 8.3.3 onwards. 

Stripe is the default payment processor in Terminalfour. When you have created a Stripe account you will have access to two sets of API keys – one for test and one for live mode. In test mode, no payment information is sent or processed. Use this to initially test the payment functionality on your form

In this example, two gateway profiles – "Test" (using the Stripe test API key) and "Production" (using the Stripe live key) have been set up: Screenshot of the Payment Gateway Listing Page showing the Stripe Test and Production Gateways

Set up a Stripe payment gateway

You'll need a Stripe account to login to the dashboard. From here, you can get the Publishable and Secret keys to set up your Payment Gateway profile. Select a key to copy it to your clipboard. In this example the test API keys are displayed:  

Screenshot of the Stripe Dashboard

Go to Administration > Settings > Payment Gateways and select Add new profile. When adding your profile details ensure that Stripe is selected from the Payment Provider dropdown and paste your Publishable and Secret keys in the provider fields:


Screenshot of the Payment Gateway Settings screen

Don't forget to Save changes.

You can switch from Test to Production when you are satisfied with the payment flow on your form.

Learn how form submissions with Stripe payments are handled.

Adding Credit Card Info with Form Builder

When a payment gateway has been set up, a CC Info field will display in Form Builder below the Advanced inputs heading:

Animated GIF showing to add Credit Card info input with Form Builder If you have more than one Payment Gateway configured (e.g., test and production gateways) you can specify the one to use in the Additional Submission Options as well as field mapping options.

The input's position can be moved up or down within the form.

Form submissions that contain Stripe payments contain the Stripe payment ID and a link to the payment.

Testing your form

It's recommended that you thoroughly test your form with a test Payment Gateway before making it live with a production Payment Gateway. Since real credit card numbers cannot be used in test mode Stripe has provided a list of test credit card numbers you can use.

Here's how a published form with a CC Info field can look:

A screenshot of a  published form with a CC Info field containing a test credit card number