Spreedly

Last updated: May 14, 2025

You can use Checkout.com as a payment processor using Spreedly.

Spreedly is a certified partner with Checkout.com.

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

See our 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 card Void
Card payouts	Money transfer Non-money transfer Online gambling

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

Request a test account with Checkout.com.
Request a Spreedly trial.

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 Spreedly 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 Spreedly dashboard:

Create a new connection to Checkout.com.
Under authentication mode, select:
- _Default – To connect to Checkout.com using the private API key you generated in the Dashboard, prefixed with Bearer. For example, Bearer <SECRET_KEY>.
- OAuth – To connect using OAuth authentication
If you're connecting to the Checkout.com Test environment, select the Sandbox checkbox.
Create a Composer Workflow to direct traffic to the Checkout.com connection.

Note

Some transactions like level 2 and 3 data do not work without a workflow.

See the Spreedly API documentation for testing your connection to Checkout.com.

Optionally, you can use our Postman collection to test payment actions.

Ensure you set up your Postman environment with the following data:
- From Spreedly, you need:
  - Environment key
  - Environment access secret
  - Checkout.com gateway token
  - Workflow key
- From Checkout.com, you need:
  - Processing channel
  - Currency account – if processing card payments

See the Postman collection for the actions to test in sandbox.

To move your integration into production, generate a private key for your Live environment and use those credentials.

Spreedly

Certified payment options

Before you begin

Set up your accounts

Create a private API key

Note

Configure the gateway integration

Note

Test your integration

Test using Postman

Move your integration to the production environment