v1

latestOpenAPI 3.0.02026-07-22290108.6 KB

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