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.
Make the first API request
Section titled “Make the first API request”After obtaining an access token, request the supported banks for the country you intend to integrate:
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.