Update a shop's settings — discovery opt-in, shop image, embed origins, and purchase-time bank authentication (purchaseAuthentication, approvalWindowSeconds) (API token, merchant:write)

PATCH /v1/integration/merchants/{id}

Error

A valid request URL is required to generate request examples

200

{
  "merchant": {
    "id": "<string>",
    "name": "<string>",
    "geo": "<string>",
    "currency": "<string>",
    "discoverable": true,
    "imageUrl": "<string>",
    "purchaseAuthentication": "off_session",
    "approvalWindowSeconds": 1050
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

Body

application/json

discoverable · boolean

imageUrl · string | null

embedOrigin · string | null

Up to three bare https origins (no path), space- or comma-separated, e.g. "https://fieldpass.shop https://staging.fieldpass.shop"; http only for localhost. Drives the frame-ancestors allowlist, the postMessage targetOrigin and buyer-API CORS. null clears them.

purchaseAuthentication · enum<string>

Whether agent purchases run off_session (default) or require buyer_present bank authentication at purchase. buyer_present is refused with 409 purchase_authentication_unsupported when the shop's default PSP cannot run the flow.

Available options: off_session, buyer_present

approvalWindowSeconds · integer

How long (seconds, 300–1800, default 600) a hold waits for the buyer under buyer_present.

Required range: 300 <= x <= 1800

Response

200 - application/json

Default Response

merchant · object · required

Show child attributes