Pasteaza has one public API base URL. All public API routes are served under the /v1 path.
Test and live mode are selected by your secret key prefix, not by a separate sandbox URL.
Base URL
Use this base URL for all Pasteaza API requests:
For example, the List Banks endpoint is:
Environments
Pasteaza determines the request environment from the secret key you send in the Authorization header.
Never use a live secret key while testing. Requests authenticated with sk_live_ are treated as live requests.
Authentication example
The request above runs in test mode because the key starts with sk_test_.
Versioning
Pasteaza includes the API version in the URL path.
Future breaking changes will use new versions, such as /v2, while keeping existing integrations working.
All API requests should include these headers:
HTTPS
Always send requests over HTTPS.
Requests sent over unsecured HTTP are rejected.
Successful responses usually look like this:
Failed responses usually look like this:
Next step
After you set your base URL, continue to the authentication guide to learn how to authorize requests.