INTRODUCTION

This document provides the integration details between the merchant & the PointCheckout systems. The integration allows the merchant system with its own shopping and order processing system to work in conjunction with PointCheckout system for the payments. The merchant would need the API credentials & the private secret key to access the PointCheckout API.

The process is outlined below:

1. When a customer is ready to pay for their order/shopping cart on the merchant system, a “Pay using PointCheckout / Card” option is presented.

2. On submitting the “Pay using Pointcheckout / Card” button, the merchant system processes the order & makes the “NEW CHECKOUT REQUEST” API call to PointCheckout & obtains a checkout key.

3. On successfully obtaining the token from PointCheckout in the previous step, the merchant system then redirects the customer to PointCheckout passing in this checkout key (See PAYMENT PAGE REDIRECT).

4. The customer then may either successfully complete the payment or cancel the payment.

5. In any of the cases in the previous step, the customer is finally returned to the merchant system.

6. Once the customer has been returned to the merchant system from PointCheckout, the merchant system makes the “GET CHECKOUT REQUEST” API call to retrieve the status of the payment and at this stage the checkout is now complete.

REQUIREMENTS

Below are the requirements that must be implemented in the shopping cart extension for PointCheckout.

1. Add a new Payment Method to the checkout page called Card payment or Pay using PointCheckout.

2. When the payment method to be used is POINTCHECKOUT, PointCheckout Logo from https://www.pointcheckout.com/en/image/logo.png must be presented to the customer at the payment page

3. Should support the following configuration options:

1. Support for Test / Live environments.

2. Ability to restrict payment to users from specific countries

3. Ability to restrict payment to users from specific user groups

4. Ability to configure new order status

SETTINGS SCREEN

The settings screen for the PointCheckout payment method should include at minimum the following configuration options.

SUPPORTED ENVIRONMENTS

The PointCheckout Payment Extension / Plugin should support the following two environments; Test and Production. Throughout the API, they will be referred to as $BASE_URL and the admin can select the current environment in the administrator settings screen.

TEST ENVIRONMENT

PRODUCTION ENVIRONMENT

API REQUESTS

There are two relevant API requests within the checkout process:

NEW CHECKOUT REQUEST

This requests sends the checkout details to the PointCheckout checkout service. It returns a unique checkout id that would be used for the processing of the payment.

REQUEST URL

METHOD TYPE

HEADER PARAMETERS

REQUEST BODY

The request is a JSON based object. It includes the following parameters