Skip to main content

Get Merchant Timezone

GET 
/customers/timezone

Returns the merchant account timezone (IANA name) configured in Paystand.

Use this before calendar-day polling jobs so f.datestart / f.dateend align with the merchant's business day — see Query and incremental sync.

Request: GET /v3/customers/timezone with Authorization: Bearer and X-CUSTOMER-ID (merchant ID from Dashboard → Integrations). No request body or path parameters beyond the fixed /timezone suffix.

Integrations OAuth note: Some merchants return 400 (apiError) with Integrations tokens even when X-CUSTOMER-ID is correct and other routes (payments, Split Fees) succeed. The handler resolves the merchant via internal currentCustomerId() context; when that context is missing, the call fails before returning timezone. Workaround: pass f.timezone explicitly on filtered list calls using a known IANA name from merchant settings.

This is not a payer customer record; it applies to the merchant identified by X-CUSTOMER-ID.

Request​

Responses​

Merchant timezone