This page describes what you need in order to integrate one of CellPoint Digital Velocity payment methods. Once you have obtained and generated the prerequisites on this page, go to API Quick Start to set up payments via API or Hosted Payment Page (HPP) to set up payments via HPP.

Prerequisites

CellPoint Digital will provide all of your sandbox account information during the onboarding process. In order to integrate payment operations via API or HPP, work with your CellPoint sales representative or account manager to obtain the following:

• HTTPS credentials - CellPoint will provide your API username and password for HTTPS Basic authentication.
• ClientID - CellPoint will provide this value, which represents a merchant's unique account ID.
• Account - CellPoint will provide this value, which represents a unique storefront.
• HMAC Salt - CellPoint will provide this value to salt the HMAC generation.
• HMAC - See below to authenticate and generate your HMAC.

How to Authenticate and Generate the HMAC

To populate the HTTPS API header, include the following:

• The HTTPS credentials for Basic authentication (provided by CellPoint).
• The 'x-cpm-sec-token' auth-parameter. This value is unique for each API request.

To generate the x-cpm-sec-token, complete these steps:

1. Extract the request/response body string.
2. Remove all space characters from the string including space, tabs, newline, and carriage return.
3. Append the salt to the body string by completing the steps below that applies to your authentication type:
   1. For Basic authentication, make the salt as base64 (API username + API password).
   2. For Bearer authentication, CellPoint provides the bearer token to be used as salt.
4. Calculate sha-256 (body + salt) of the string.
5. Set this hash string as the x-cpm-sec-token header in the request/response.

The following is an example of the parameters in the header section.

Once you have the prerequisites above, you're ready to integrate payment operations. See API Quick Start to set up payments via API or Hosted Payment Page (HPP) to set up payments via HPP.