# Overview

The Monetarie **Partner API** is the server-to-server interface your system uses to create customers, open and query accounts, send PIX and TED, and receive webhooks. Every catalog call is scoped to the partner that owns the credential: a partner only sees and moves the accounts, customers and webhooks it created.

## Base URL

The collection and examples use the `{{baseUrl}}` variable. Point it to the Core endpoint Monetarie provides for your environment. Do not use a trailing slash.

```
{{baseUrl}}/api/partner/v1
```

## Integration flow

1. Receive your `client_id` and `client_secret` (generated in the Monetarie panel).
2. Exchange them for an access token at `POST /api/partner/v1/oauth/token`. See [Authentication](/en/authentication).
3. Send the token in the `Authorization: Bearer <access_token>` header on every other call.
4. For money-moving operations, send an `Idempotency-Key` header to prevent duplicates.
5. Register [webhooks](/en/endpoints/webhooks) to receive events asynchronously.

## Money values

- PIX and transfer inputs use **cents** (integer). Example: `1500` is R$ 15.00.
- Balance, statement and receipt are returned in **reais** (decimal number).

## Idempotency

Money-moving write operations (create customer, send PIX, send TED, internal transfer) accept the `Idempotency-Key` header. Retries with the same key return the original response.

## Errors

Error responses follow a consistent shape, with the appropriate HTTP code:

```json
{
  "error": {
    "status": 403,
    "message": "Insufficient permission for this operation"
  }
}
```

| Code | Meaning |
|---|---|
| `400` | Malformed request |
| `401` | Missing, invalid or expired token |
| `403` | Insufficient scope or another partner's resource |
| `404` | Resource not found |
| `422` | Invalid data (validation) |

## Tools

- **Postman:** [download the collection](/Monetarie-Partner-API.postman_collection.json) and fill in `baseUrl`, `client_id` and `client_secret`. The collection handles the token and the `Authorization` header for you.
- **Interactive reference:** the contract specification (OpenAPI) is available in the Core environment Monetarie provides.