Release NotesAnnouncementsVideosBlog
Guides

Ecommerce app permissions

North America—United States and Canada

Your app must request specific permissions from merchants to access and update their data. In addition, on the Developer Dashboard, you must specify the Ecommerce integration type you are using for your app.

Required app permissions

Merchants using your app grant your app permissions during installation, and your app will use the associated OAuth token to use for all API calls on behalf of the merchant. For more information, see Authenticate with OAuth—Canada and US.

Your app should only request the minimum permissions required for your app to function.

PAKMS service endpoint

OperationRequired permission
Get public key
GET /pakms/apikey		Online payments

Tokenization service endpoint

OperationRequired permissions
Create token
POST /v1/tokens		None

🚧

IMPORTANT

To create a token using POST /v1/tokens, you need a public key retrieved from the PAKMS service.

Ecommerce service endpoints

Charge endpoints

OperationRequired permissions
Create a charge
POST /v1/charges		Online payments
Capture an open charge
POST /v1/charges/{chargeId}/capture		Read payments
Write payments
Online payments
Get charges
GET /v1/charges		Read payments
Get a single charge
GET /v1/charges/{chargeId}		Read payments

Customer endpoints

OperationRequired permissions
Create a card-on-file customer
POST /v1/customers		Read customers
Write customers
Online payments
Add a card to an existing customer
PUT /v1/customers		Read customers
Write customers
Online payments
Remove a card from an existing customer
DELETE /v1/customers		Read customers
Write customers
Online payments

Order endpoints

OperationRequired permissionsAdditional permissions
Create an order
POST /v1/orders		Read merchant
Read orders
Write orders		To add a customer:
Read customers

To add tax_rates to items:
Read inventory
Get orders
GET /v1/orders		Read orders
Read payments
Get an order
GET /v1/orders/{orderId}		Read customers
Read merchant
Read orders
Read payments
Pay for an order
POST /v1/orders/{orderId}/pay		Read customers
Read inventory
Read merchant
Read orders
Read payments
Online payments
Return an order
POST /v1/orders/{orderId}/returns		Read customers
Read merchant
Read orders
Read payments
Online payments

📘

NOTE

Getting an order with GET /v1/orders/{orderId} expands the following fields:

  • lineItems
  • lineItems.taxRates
  • payments
  • refunds
  • customers

Refund endpoints

OperationRequired permissions
Get refunds
GET /v1/refunds		Read payments
Get a refund
GET /v1/refunds/{refundId}		Read payments
Refund a charge
POST /v1/refunds		Read customers
Read merchant
Read orders
Read payments
Online payments

Recurring Payments service endpoints

Plan endpoints

OperationRequired permissions
Create plan
POST /v1/plans		Read merchant
Write merchant
Get a plan
GET /v1/plans/{planId}		Read merchant
Edit a plan
PUT /v1/plans/{planId}		Read merchant
Write merchant
Deactivate a plan
PUT /v1/plans/{planId}		Read merchant
Write merchant

Subscription endpoints

OperationRequired permissions
Create a subscription
POST /v1/plans/{planId}/subscriptions		Read customers
Write customers
Get a subscription
GET /v1/subscriptions/{subscriptionId}		Read merchant
Read customers
Edit a subscription
PUT /v1/subscriptions/{subscriptionId}		Read customers
Write customers
Cancel a subscription
PUT /v1/subscriptions/{subscriptionId}		Read customers
Write customers
Read merchants

Set app permissions and integration type

  1. Log in to the Developer Dashboard.
  2. From the left navigation menu, click Your Apps > App name > App Settings. The App name - App Settings page allows you to view and configure settings and permissions that your app requires for accessing Clover merchant data.
  3. Click Requested Permissions. The Edit Requested Permission page appears.
  4. Select your app's read or write permissions for Ecommerce API, as required. For any selected permission, provide an in-line comment about how your app is using this information.
  5. Click Save. Your selected permissions are displayed on the App Settings page.
  6. Click Ecommerce Settings. The Edit Ecommerce Settings page appears.
  7. Select your integration type. See Integration types for more information.
  8. Click Save. Your selected integration type displays on the App Settings page.

Updated 6 months ago