Checkout.com Payment Gateway: Configuration

The Checkout.com Payment Gateway Add-on allows you to accept online payments processed through the Checkout.com platform directly in the Chauffeur Taxi Booking System booking form. Configuration consists of three main steps:

1. Generating or copying the required credentials in your Checkout.com Dashboard.
2. Entering these credentials and basic settings in the booking form configuration.
3. Enabling Checkout.com as an available payment method for the booking form.

Generating Checkout.com Credentials

To configure the add-on, you need the following Checkout.com credentials:

• Secret API Key
• Processing Channel ID
• Webhook Signature Key

You can generate these credentials in your Checkout.com Dashboard.

1. Go to the Checkout.com Dashboard and log in to your account. For testing, use the Checkout.com Sandbox Dashboard.
2. Open ‘Developers’ -> ‘Keys’.
3. Click ‘Create a new key’.
4. Select ‘Secret API key’ as the key type and click ‘Create key’.
5. Copy the generated value beginning with sk_. This is your Secret API Key.
6. Open the created key to display the ‘Key details’ page.
7. In the ‘Selected processing channels’ section locate and copy the value beginning with pc_. This is your Processing Channel ID.
8. Next, go to ‘Developers’ -> ‘Webhooks’.
9. Click ‘Create configuration’.
10. Enter a name for the webhook configuration.
11. In the ‘Endpoint URL’ field enter the URL of your website where the Chauffeur Taxi Booking System plugin is installed.
12. Click ‘Generate key’ next to the ‘Signature Key’ field.
13. Create and save the webhook configuration.
14. Open the webhook configuration details and copy the generated ‘Signature Key’. This is your Webhook Signature Key.

Configuring Checkout.com in the Booking Form

Once the add-on is installed and activated, you can configure Checkout.com for each booking form individually.

1. In your WordPress dashboard, go to ‘Chauffeur Booking System’ -> ‘Booking Forms’.
2. Edit the booking form where you want to enable Checkout.com payments.
3. Open the ‘Payments’ tab of the form editor.
4. Go to the sub-tab ‘Payments’ and then click the ‘Checkout.com’ payment method tab.

On the ‘Checkout.com’ tab you will find the following options:

Sandbox Mode

Enable this option if you want to test the integration using the Checkout.com sandbox environment. Disable it when you are ready to process real payments using your live Checkout.com account.

Secret API Key

Paste here your Checkout.com Secret API Key, copied from the Checkout.com Dashboard. This key authorizes the Chauffeur Taxi Booking System to communicate with the Checkout.com API.

Processing Channel ID

Enter the Processing Channel ID assigned to the key and account configuration you want to use for processing payments.

Webhook Signature Key

Paste here the Signature key from your Checkout.com webhook configuration. This key is used to verify webhook notifications sent by Checkout.com.

Success URL

Enter the full URL, including https://, where customers should be redirected after a successful payment. We recommend using a dedicated “Thank you” or booking confirmation page.

Failure URL

Enter the full URL, including https://, where customers should be redirected if the payment fails.

Cancel URL

Enter the full URL, including https://, where customers should be redirected if they cancel the payment process.

Redirection Delay

Set the delay, in seconds, before the customer is redirected from the booking form to the Checkout.com payment gateway.

Logo

Optionally, you can upload a custom logo that will be displayed on step #3 of the booking form when the customer selects the Checkout.com payment method.

Information for the Customer

Use this field to display additional information to the customer before they are redirected to the Checkout.com gateway.

Enabling Checkout.com as a Payment Method

After entering the Checkout.com settings, you still need to enable this gateway as one of the payment options in the booking form:

1. While still editing the booking form, go to ‘Payments’ -> ‘General’.
2. In the ‘Payment’ option, select ‘Checkout.com’ as one of the available payment methods for this form.
3. Optionally, set ‘Checkout.com’ as the ‘Default Payment’ if you want it to be preselected for customers.
4. Click ‘Update’ or ‘Publish’ to save your changes.

Debugging and Log Manager

After installing the add-on, a new settings section will appear in your WordPress dashboard under ‘Settings’ -> ‘Chauffeur Booking System: Checkout.com’. This section includes a Log Manager tool that allows you to verify the correctness of your configuration and review any errors or warnings related to the payment process.