Skip to main content

Connecting Checkout.com

This guide walks through the full setup of a new Checkout.com merchant account under Splitit. You proceed by requesting a new Checkout.com MID, creating a Checkout.com API key, sending your creds to Splitit, and configuring webhooks and settlement reports. Finally, you test and validate your installation.

Create a Dedicated MID with Checkout.com Support​

  1. Provision a new Merchant ID (MID) with Checkout.com by contacting their support team. This MID must adhere to a few Splitit settings:
    • Force capture enabled
    • Auth Expiration aligned with your installment cycle (typically monthly)

Create API Key and Send Creds to Splitit​

  1. Go to Developers in the Checkout.com Dashboard (it's the </> symbol at upper right).
developers link
  1. Click Keys.
key section
  1. Click Create a new key.
create a new key
  1. Select Secret API key (server-side authentication).
select secret api key
  1. Scroll to the bottom of the screen and select Create Key.
create key
  1. Scroll up and copy/export your Secret API Key (it will only be displayed once).
copy/export key
  1. Below that section, you also need to copy your ProcessingChannelId.
copy processing channel id
  1. Contact your personal Onboarding Manager or the Onboarding Team at onboarding@splitit.com to get a secure form link. On this form, you will need to provide your Secret API Key and your ProcessingChannelId.
danger

For security reasons, do not send these credentials by email or chat. Instead, please use the secure form link we provide.

Configure Webhooks​

  1. Go to Developers in the Checkout.com Dashboard (the </> symbol at upper right).
developers link
  1. Navigate to Webhooks.
webhooks link
  1. Click Create configuration.
create config
  1. Add Splitit to the name field.
add name
  1. Set your Endpoint URL to:
    https://notifications.production.splitit.com/api/notifications/CHECKOUT
set url
  1. Generate an Authorization Header Key and a Signature Key by clicking Generate key for each.
auth and signature keys
  1. Under Events, use checks to select ALL of the webhook events in the following sections:
  • Client settlements
  • Disputes
  • Fraud
  • Gateway
checkmarks for webhooks
  1. Add any other webhook events you would like, then proceed to the bottom of the page and click All entities and processing channels under Entities and Processing Channels.
all entities
  1. Scroll back to the top and click Send test at upper right to use Checkout.com's testing option.
send test
  1. You should receive a success message:
success message
  1. Finally, scroll to the bottom and click Create webhook.
create webhook

Configure Settlement Reporting​

Configure reporting and settlement files to be delivered directly to Splitit by contacting Checkout.com support. Ensure the frequency matches your Splitit account's reconciliation requirements (typically daily).

Test and Validate​

Before you go live, there are a few things you should do:

  1. Run a test transaction in your Splitit implementation and confirm that authorization, capture and settlement all function properly.
  2. Contact your personal Onboarding Manager or the Onboarding team at onboarding@splitit.com to verify that:
    • All of your webhooks are arriving at the Splitit endpoint with the correct payloads
    • Your settlement report delivery is functioning properly

This concludes the process, but for any additional assistance please contact your Onboarding Manager or the Onboarding Team at onboarding@splitit.com.