2Checkout APIs

Overview

Use the 2Checkout API to:

• Build apps that connect to the 2Checkout system

• Place and manage orders

• Manage subscriptions and customers

• Create, update, and extract product catalog and pricing information for your account

• Manage partner accounts

• Integrate with 2Checkout to automate your backend operations

Before you start using the 2Checkout API, make sure you check whether your integration requires PCI compliance. Find out more details about what PCI compliance means and what you must do to be PCI compliant here: https://verifone.cloud/docs/2checkout/Onboarding/Merchant-PCI-Compliance

Availability

2Checkout API is available for all accounts.

Protocols and versioning

The 2Checkout API is accessible under three protocols across a number of major and minor versions.

The URL for each API protocol and version is composed by following this rule:

https://api.2checkout.com/{protocol}/{version}

The 2Checkout API is accessible under three protocols:

• REST - under https://api.2checkout.com/rest/

• SOAP - under https://api.2checkout.com/soap/

• JSON-RPC (standard RPC protocol with the payload being JSON encoded) - under https://api.2checkout.com/rpc/

In order to maintain backward compatibility, any changes or new features that would break existing integrations are published under a new API version. The current latest version of the 2Checkout API is API version 6.0 (publicly launched in December 2019).

Accessing a certain version of the 2Checkout API is easy, as the API version is used in the API URL: https://api.2checkout.com/{protocol}/{version}.

Pagination in API

All main resources used in the 2Checkout API support searching and pagination.

This is achieved by using two standard parameters: page and limit. Both parameters are integers, optional, and can be passed as NULL.

"Pagination": {
    "Page": 1,
    "Limit": 10,
}

The page and limit parameters can be sent directly in the payload of the request, or, in some cases, under a Pagination object.

Typically, the response for a search call will return a list of items, as well as the provided pagination options. Additionally, a total count of items is provided in order to facilitate navigation.

"Pagination": {
    "Page": 1,
    "Limit": 10,
    "Count": 230
}

Connect to the 2Checkout API

1

Sign up and activate

Sign up for a 2Checkout account and get it activated:

https://verifone.cloud/docs/2checkout/Onboarding/Get-started-with-your-2Checkout-account https://verifone.cloud/docs/2checkout/Onboarding/Activate-and-set-up-your-2Checkout-account

2

Get your credentials

To connect to the 2Checkout API, log in to your 2Checkout account and get your:

• merchant code

• secret key

• secret word

Login: https://secure.2checkout.com/cpanel/logon.php

3

Retrieve codes from the Merchant Control Panel

These unique codes are automatically generated for your account. Retrieve them from your Merchant Control Panel Dashboard → Integrations → Webhooks and API.

4

Copy merchant code and secret word

Copy the merchant code (found in the API section) and the Instant Notification Service (INS) secret word found in the Secret word area.

secret word.png

API Authentication

Use the merchant code and secret key to authenticate with the API. Follow this guide to learn how to authenticate with the 2Checkout API: https://verifone.cloud/docs/2checkout/API-Integration/01Start-using-the-2Checkout-API/API_Authentication

Read the API documentation

Once you've authenticated with the API, you can start configuring your environment for your specific business scenarios.

• JSON-RPC API Reference

• SOAP API Reference

• REST API Reference

2Checkout GitHub

Visit the repository to download and contribute to code samples.

Webhooks

• Instant Payment Notification (IPN) - automatic order/transaction notifications

• License Change Notification (LCN) - automatic subscription notifications

• Instant Notification Service (INS) - automatic notifications containing full event information