Generate an Ecommerce API key (PAKMS key)
Overview
The Ecommerce API key is required to complete the OAuth flow for using the Clover Ecommerce API. This key is provided by the Public Access Key Management Service (PAKMS) and is also known as the apiAccessKey
. It is unique to each merchant and does not expire. You need to send a request to the PAKMS endpoint only once for each merchant when they first install and configure your app. Your app should store the returned Ecommerce API key for use in each of that merchant’s subsequent card tokenization. See the Ecommerce - PAKMS API reference for more information.
Generate an Ecommerce API key
- Generate an OAuth API token or
access_token
. - Send a GET request to the
https://scl-sandbox.dev.clover.com/pakms/apikey
endpoint. - Use the OAuth API token or
access_token
as the Bearer token in your request.
In response, the Clover server returns an apiAccessKey
, which is the Ecommerce API key or PAKMS key. You can use theapiAccessKey
as the apikey
header when you tokenize a card.
Request example
curl --request GET \
--url 'https://scl-sandbox.dev.clover.com/pakms/apikey' \
--header 'Authorization: Bearer {access_token}'
Response example
{
"active": true,
"apiAccessKey": "af4exxxxxxxxxxxxxxxxxxxxxxxxd145",
"createdTime": 1722230745532,
"developerAppUuid": "RKxxxxxxxxx9C",
"merchantUuid": "6Xxxxxxxxxx91",
"modifiedTime": 1722230745532
}
Related topics
- Ecommerce PAKMS API: Retrieve an Ecommerce API key endpoint.
- Card tokenization service API: Create a card token endpoint.
- Ecommerce API Reference for additional steps to work with charges, customers, orders, refunds, and more.
- Blog: Fiddling Through Digital Keys: Clover Auth Tokens and Ecommerce Keys
Updated 4 days ago