Skip to main content
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.

Request headers

All API requests should include these headers:

HTTPS

Always send requests over HTTPS. Requests sent over unsecured HTTP are rejected.

Standard response format

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.