Create or Update Widget Configuration

Configures checkout preferences (language, expiration time, and default redirect URLs).

  • Customer-level default: When account_id is omitted, the configuration applies to all accounts under your customer organization. - Account-level override: When an account_id (UUID) is provided in the body, this creates or updates an override for that specific account.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string

Optional Account UUID. When present, configures an account override. When omitted, configures the Customer-level default.

string

Descriptive name for the configuration.

string
enum
Defaults to light

UI color mode for the hosted checkout.

Allowed:
string
enum
Defaults to en

Default language for the hosted checkout page.

Allowed:
uri

Default redirect destination upon successful payment.

uri

Default redirect destination if payment fails.

integer
≥ 1
Defaults to 60

Lifetime of generated links in minutes.

boolean
Defaults to true

Whether this configuration is active.

Responses

401

Unauthorized

404

Account not found (when account_id is provided but inaccessible)

422

Validation error

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json