Checkout.com Module

Collect card payments with Checkout.com and let clients save a card for future renewals.

Reaching the Screen

Go to Settings → Financial → Payment Gateways, open All Modules and click Checkout.com: {admin}/modules/payment?module=CheckoutCom

Use Payment Gateways to manage the methods clients see.

What Is on the Screen

The module card contains API keys, webhook verification, processing channel, payment method and environment settings.

In this version, the normal payment flow uses your site's card form. The client may then complete bank verification. Saved cards and automatic payments are supported; provider-managed subscriptions and installments are not.

The module also contains a hosted payment page integration. Its allowed-method list affects that page; it does not change the normal card form.

Before You Configure It

• A Checkout.com account enabled for your country, currency and payment methods, plus sandbox access for testing.
• Public and secret API keys from the same environment, with permission to tokenize cards, manage instruments, request and read payments, and issue refunds.
• A reachable HTTPS callback address and its webhook signature key.

Fields

For Status, commission, currency conversion, amount limits and country lists, see Payment Gateways. Callback URL, Success URL and Failed URL are supplied by WISECP.

Tasks

Create the API keys

1. In the Checkout.com Dashboard, open Developers → Keys → Create a new key.
2. Create public and secret keys for the test environment. Allow the processing channel and the operations listed under prerequisites.
3. Copy the keys. Under Developers → Keys, open the applicable key and copy its associated processing channel ID.

Connect the account

1. Open the Checkout.com module card and select Status to unlock its settings.
2. Enter Secret Key, Public Key and, if needed, Processing Channel ID.
3. Select Test Mode for sandbox keys and keep Capture Automatically enabled for immediate collection.
4. Click Save Changes. The gateway settings are saved; complete webhook setup before testing a payment.

Configure payment notifications

1. Copy Callback URL from the module card.
2. In the same Checkout.com environment, open Developers → Webhooks and create a configuration for that HTTPS address.
3. Include payment_captured and payment failure events such as payment_declined and payment_capture_declined. Save the configuration and copy its signature key.
4. Enter it in Webhook Signature Key and click Save Changes. WISECP can now verify notifications sent to this address.

Test the client payment

1. As a client, start a test order or open an unpaid invoice and select the Checkout.com payment method.
2. Enter a Checkout.com test card in the card form. Complete any bank verification requested.
3. Check the payment in Checkout.com and the invoice in WISECP. A completed capture marks the invoice paid; authorization alone leaves it open.
4. Before taking real payments, replace both keys and the webhook configuration with production values, clear Test Mode, and save.

Enable saved cards and renewals

1. Return to Payment Gateways → Initial Settings. Select Checkout.com under Card Storage Module and click Save Changes.
2. The account owner can add a card from their client account or save it during payment. Card registration uses a zero-amount verification.
3. The client selects Turn On Auto-Pay from the card menu under Saved Cards. Renewal invoices can then use automatic collection.
4. A successful renewal payment closes its invoice. Removing the saved card also removes its reusable instrument from Checkout.com.

Refund an invoice

1. Open the paid invoice: {admin}/invoices/detail?id={invoice}
2. Under Summary → Change Status, select Refunded and Refund via payment gateway.
3. Click Update Status. An accepted refund request updates the invoice; check completion in Checkout.com.

Things to Watch

Required Privileges

Payment Module Settings (MODULES_PAYMENT_SETTINGS) is required to configure the module. Refunds also require INVOICES_OPERATION.

Related Articles

• Payment Gateways
• Invoice Detail Overview