Connect Your Checkout Champ Account to Adyen

For merchants with an existing Checkout Champ store and Adyen payment gateway.

Checkout Champ

×

Adyen

Platform

Checkout Champ

Gateway

Adyen

Video walkthrough

The same setup, start to finish, on screen. The written steps below follow the video exactly.

How to Integrate Adyen Gateway with Checkout Champ

1. Activate Adyen v2 in Checkout Champ

  1. Log in to your Checkout Champ Admin account: app.checkoutchamp.com

  2. Navigate to CRM → Gateways → Gateway Integrations.

  3. Locate Adyen v2 (Apple Pay & Google Pay).

  4. Click + Activate.

  5. The Create New Gateway page will open.

Keep two tabs open

Leave this page open — you’ll return to it after gathering credentials from Adyen. Open the Checkout Champ Knowledge Base article for Adyen in a separate tab (you’ll copy a webhook URL from it later).

2. Locate your Adyen API credentials

  1. Log in to your Adyen Customer Area.

  2. Navigate to Developers → API Credentials.

  3. You should see an existing API credential configuration. Open it to edit.

Enable required roles

Very important

Best results occur when all roles are checked.

  1. Scroll to the bottom of the API credential page.

  2. Under Roles, enable every available role.

  3. Click Save Changes.

  4. Scroll back to the top after saving.

API key notes

Generate an API Key if one is not already present.

If the gateway will not save

Checkout Champ may occasionally reject API keys containing certain special characters. If the gateway fails to save or authenticate, generate a new API key and try again until it saves successfully.

Copy the API Key — you’ll paste this into Checkout Champ shortly.

3. Copy your API URL prefix

  1. In Adyen, go to Developers → API URLs.

  2. Locate your Live API URL Prefix.

  3. Copy this value exactly.

This will be used in the Checkout Champ gateway setup.

4. Create Adyen webhooks

  1. In Adyen, navigate to Developers → Webhooks.

  2. Click + Create Webhook.

  3. Choose Standard Webhook.

Webhook configuration

Fill in the webhook settings as follows:

  • Server Configuration URL: Paste the webhook URL provided in the Checkout Champ Knowledge Base article you opened earlier.

  • Method: JSON

  • TLS Version: TLS 1.2

Events to enable

Select only the following events:

  • Authorization

  • Capture

  • Refund

Click Save Configuration.

5. Generate and copy the HMAC key

  1. While still on the webhook page, go to Security.

  2. Generate a new HMAC Key.

  3. Copy the HMAC key.

  4. You’ll paste this into the HMAC Key field in Checkout Champ.

6. Set your transaction descriptor

  1. In Adyen, go to Settings → Transaction Description.

  2. Select Merchant Account as the dynamic value.

  3. Set the descriptor value as desired. This controls what appears on customer bank statements.

  4. Copy this value.

  5. Paste it into the Descriptor field in the Checkout Champ Adyen gateway setup.

7. Complete the gateway setup

Return to the Create New Gateway page in Checkout Champ and fill in the required fields:

  • API Key: From Adyen API Credentials

  • API URL Prefix: From Adyen API URLs

  • HMAC Key: From Adyen Webhook Security

  • Descriptor: From Transaction Description

  • Enabled: Must be checked

Before you save

Double-check all values carefully. Click Create Gateway once complete.

8. Assign the gateway to your campaign

  1. In Checkout Champ, go to CRM → Campaigns.

  2. Open a campaign you want to use Adyen with.

  3. Navigate to Offers → Options → Batch Update.

  4. Under General Settings, set Gateway Account to your new Adyen gateway.

  5. Save changes.

9. Test the integration

  1. Run a test card through one of the products in that campaign.

  2. If the transaction processes successfully, the integration is complete.

  3. You can now begin running live transactions.

You’re all set

You’ve successfully integrated Adyen with Checkout Champ. If you encounter any issues, contact your Checkout Champ Account Manager, reach out to your Compaytence representative, or book a call directly through Compaytence.com.