Base URL and API key
The two things you need before you can call anything.
| Item | Description |
|---|---|
| Base URL | The root address of the API. Every path on this site is written relative to it. |
| API key | A secret key that authenticates every request. Issued once at account activation. |
Not issued yet? Your base URL and API key are provided during account onboarding. Until then, examples on this site show {BASE_URL} as a placeholder.
How paths are written#
The base URL INCLUDES the version segment. It ends in /v1, for example https://api.maly.pay/v1. Every endpoint path on this site is written relative to that, so it never repeats the version. A full URL looks like this:
{BASE_URL}/paymentsDo not add the version twice. Your base URL already ends in /v1. Appending a path that also starts with the version produces a doubled version segment and returns a 404. Append the paths exactly as written on this site, each starting with a single slash after the base URL.
Bind your base URL to this site#
Paste your base URL, the one ending in /v1, into the bar at the top of any page. Every code sample and endpoint path on the site rewrites to use it, and the value is remembered on your machine. It is never sent anywhere.
Maly Tech Ltd. This guide is provided for information. Where it differs from your signed agreement, the agreement applies.