Primer.io

Last updated: May 14, 2025

You can use Checkout.com as a payment processor using Primer.io

Checkout.com has tested and verified the following actions for this payment method.

See the Primer.io Postman collection for examples of each use case.

Payment option	Supported actions
Card payments Apple Pay Google Pay	Authorize Authorize account funding transactions (AFTs) Authorize with 3DS Authorize with dynamic descriptors Authorize with level 2 and 3 data Authorize with surcharge Capture Combined authorize and capture Partial and multiple capture Partial and multiple refund Recurring authorization Refund Unscheduled authorization Verify a card Void

You must set up your accounts with Checkout.com and Primer.io, and create a private key to configure the integration.

Sign in to the Test environment in the Dashboard.
Select the Developers icon in the top navigation bar and open the Keys tab.
Select Create a new key.
Under Type of key, select Secret API key.
Enter a description for the API key to help you identify what it's used for.
Under Scopes, select Default.
Turn off the Allow any processing channel setting.
Select the processing channel you want to use for Primer.io payments from the list.
Select Create key.
Copy your private API key securely. You'll need it to configure the plugin.

Note

For security reasons, you cannot view the private API key again after you've left the Create a new key page. Ensure you copy the value securely before you exit or close the window.

In your Primer.io dashboard:

Select Integrations > New integration.
Search for Checkout.com, and select Connect.
Configure your account details:
1. Under Account, enter your merchant trading name.
2. Under Secret key, enter the private API key you generated in the Dashboard, prefixed with Bearer. For example, Bearer <SECRET_KEY>.
3. Under Processing channel ID, enter the ID of the processing channel you want to use for Primer.io.

Checkout.com communicates status updates for your payments through webhooks. To configure your Primer.io endpoint to receive webhooks:

Sign in to the Dashboard.
Select the Developers icon in the top navigation bar and open the Webhooks tab.
Select Create configuration.
Add a name for your webhook.
In the Endpoint URL field, enter one of the following URLs depending on the environment you want to configure:
- Sandbox – https://api.sandbox.primer.io/callbacks/checkout?api_key={YOUR_PRIMER_API_KEY}
- Production – https://api.primer.io/callbacks/checkout?api_key={YOUR_PRIMER_API_KEY}
Under Events, select all the event checkboxes.
Under Entities and processing channels, select All entities and processing channels.
Select Create webhook.

Primer.io

Certified payment options

Before you begin

Create a private API key

Note

Configure the integration

Configure webhooks