Skip to main content

Overview

Commerce API keys (ck_...) authorize commerce operations (search, merchant carts, checkout, orders, payments).

Authentication

  • Key management uses Authorization: Bearer <jwt>.
  • Commerce operations use x-commerce-api-key.

Request

List commerce API keys

Create a commerce API key

Revoke a commerce API key

Response

Example list response (truncated):
Example create response (save api_key now; it is only returned once):
Example revoke response:

Errors

  • 401 missing/invalid auth
  • 403 key suspended/expired

Examples

  • Save newly created keys securely; full key material is typically returned once. Next: Payment sessions