Skip to content

Environments and first request

Resource Sandbox Production
API https://api.sandbox.ztlpay-test.io https://api.ztlpay.io
OIDC https://oidc.sandbox.ztlpay-test.io https://oidc.ztlpay.io
Onboarding UI https://welcome.sandbox.ztlpay-test.io/onboarding https://welcome.ztlpay.io/onboarding

Credentials, data, consent, and resource IDs do not cross environments. Keep environment configuration explicit and never derive a production host by editing a sandbox URL at runtime.

After obtaining an access token, request the supported banks for the country you intend to integrate:

Terminal window
curl --request GET \
--url https://api.sandbox.ztlpay-test.io/api/v2/banks/NO/supported \
--header 'authorization: Bearer ACCESS_TOKEN'

Check the HTTP status before parsing the body. Capture the ztl-request-id response header even for successful calls.

The supported-bank response is the runtime source for available products and constraints. See Capabilities and constraints.