Gr4vy

Last updated: July 9, 2025

To integrate with Gr4vy, you must first set up and test your integration in the Test environment, and then move your integration to the Live environment.

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

For examples of each use case, see our Postman collection.

Payment option	Supported actions
Card payments Apple Pay Google Pay	Authorize Authorize with 3DS Authorize with dynamic descriptors Capture MOTO Authorization Partial Authorization Partial capture Partial and multiple refund Recurring authorization Refund Unscheduled authorization Verify card Void
Card payouts	Online gambling

Additionally, you can create and delete payment instruments

You must create a public and private key to configure the integration.

Request a test account with Checkout.com.
Request a Gr4vy sandbox account.

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.
When you're prompted for which type of key to create, select Public API key.
Give the API key a description. This will help you identify what it's used for.
Disable the Allow any processing channel setting.
Select one processing channel from the list.
Select Submit to create the key.

Make a note of your public API key as you'll need it for a later step. You can view your public API key at any time after creation.

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.
Give the API key a description. This will help you identify what it's used for.
Under Scopes, select Default.
Disable the Allow any processing channel setting.
Select the processing channel you want to use for Gr4vy payments from the list.
Select Create key.
Copy your private API key securely. You'll need it to configure the plugin.

Note

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

In your Gr4vy dashboard:

Create a new connection to Checkout.com.
Under Credentials, enter your the following credentials:
- Public key
- Private key, prefixed with Bearer. For example, Bearer <SECRET_KEY>.
- Webhook secret key
- Payouts funding account – if you will process payouts.
Add the Checkout.com connection to the Card Transactions flow.

For information on how to test your connection to Checkout.com, see the Gr4vy API documentation.

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

Ensure you set up your Postman environment with the following data:
- From Gr4vy, you need:
  - Key ID
  - Private key
  - Payment service ID
  - Gr4vy ID
- From Checkout, you need:
  - Processing channel

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

To move your integration to Production, you must:

Follow the create a public and private key instructions in Checkout.com's Live environment.
Configure Gr4vy gateway integration using the new public and private keys.

Gr4vy

Certified payment options

Before you start

Set up your accounts

Create a public API key

Create a private API key

Note

Configure the gateway integration

Test your integration

Test using Postman

Move your integration to the production environment