Sign in
Client IDs
V2/Client IDs

Create a new client ID

Create a new client ID for frontend applications with domain restrictions

post/v2/client-ids

Headers

x-api-keystring required

API key for authentication

Request body

labelstring required
allowedDomainsstring[] required

List of allowed domain origins (normalized)

feePercentagestring

Fee percentage (e.g., '1' = 1%, '2.5' = 2.5%, '2.55' = 2.55%). Maximum 2 decimal places. If set to '0', allows API request fees to take precedence. If set to any other value, overrides any fee passed via API.

feeAddressstring

Wallet address to receive fees. Required if feePercentage is set.

operatorWalletAddressstring

Wallet address that will act as operator for commerce payments. The API operator wallet will execute transactions on behalf of this address. Can be a smart wallet that has granted permissions to the API operator.

defaultPreApprovalExpiryinteger

Default pre-approval expiry duration in seconds for commerce transactions. If set, overrides the value passed in /v2/commerce-payments/authorize/calldata endpoint.

defaultAuthorizationExpiryinteger

Default authorization expiry duration in seconds for commerce transactions. If set, overrides the value passed in /v2/commerce-payments/authorize/calldata endpoint.

Response

Client ID created successfully

idstring
clientIdstring
labelstring
allowedDomainsstring[]
feePercentagestring nullable
feeAddressstring nullable
operatorWalletAddressstring nullable
defaultPreApprovalExpirynumber nullable
defaultAuthorizationExpirynumber nullable
statusstring
createdAtstring

Changes