Version: 1.9.0

Export

* [OpenAPI Spec](https://js.monei.com/api/v1/openapi.json)

# MONEI API v1

The MONEI API is organized around REST principles. Our API is designed to be intuitive and developer-friendly.

### Base URL[​](#base-url "Direct link to Base URL")

All API requests should be made to:

```
https://api.monei.com/v1
```

### Environment[​](#environment "Direct link to Environment")

MONEI provides two environments:

* **Test Environment**: For development and testing without processing real payments
* **Live Environment**: For processing real transactions in production

### Client Libraries[​](#client-libraries "Direct link to Client Libraries")

We provide official SDKs to simplify integration:

* [PHP SDK](https://github.com/MONEI/monei-php-sdk)
* [Python SDK](https://github.com/MONEI/monei-python-sdk)
* [Node.js SDK](https://github.com/MONEI/monei-node-sdk)
* [Postman Collection](https://postman.monei.com/)

Our SDKs handle authentication, error handling, and request formatting automatically.

You can download the OpenAPI specification from the <https://js.monei.com/api/v1/openapi.json> and generate your own client library using the [OpenAPI Generator](https://openapi-generator.tech/).

### Important Requirements[​](#important-requirements "Direct link to Important Requirements")

* All API requests must be made over HTTPS
* If you are not using our official SDKs, you **must provide a valid `User-Agent` header** with each request
* Requests without proper authentication will return a `401 Unauthorized` error

### Error Handling[​](#error-handling "Direct link to Error Handling")

The API returns consistent error codes and messages to help you troubleshoot issues. Each response includes a `statusCode` attribute indicating the outcome of your request.

### Rate Limits[​](#rate-limits "Direct link to Rate Limits")

The API implements rate limiting to ensure stability. If you exceed the limits, requests will return a `429 Too Many Requests` status code.

## Authentication[​](#authentication "Direct link to Authentication")

* API Key: APIKey
* API Key: AccountId

The MONEI API uses API keys to authenticate requests. Each request must include your API key in the `Authorization` header. You can view and manage your API keys in the [MONEI Dashboard](https://dashboard.monei.com/settings/api). MONEI provides two types of API keys: test mode keys (prefixed with `pk_test_`) and live mode keys (prefixed with `pk_live_`).

| Security Scheme Type:  | apiKey        |
| ---------------------- | ------------- |
| Header parameter name: | Authorization |

If you're integrating with MONEI as a partner or platform, you'll need to use both your Master Account API Key and the Account ID of the merchant you're acting on behalf of. You can find the Account ID for each connected merchant in your [MONEI Partner Dashboard](https://admin.monei.com).

| Security Scheme Type:  | apiKey           |
| ---------------------- | ---------------- |
| Header parameter name: | MONEI-Account-ID |