> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wava.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Partners API

> Create orders and payment links on behalf of your onboarded stores.

# Partners API

The Partners API allows approved partners to operate on behalf of the stores they have onboarded into the Wava platform. Partners can create orders, generate payment links, and access store data using their API credentials.

## How it works

Partners are businesses that onboard and manage multiple stores. Instead of each store integrating the Wava API individually, the partner handles the integration and creates transactions on their behalf.

When a partner makes an API call, they include three authentication headers:

* `X-API-Key`: Partner API key for identification
* `X-API-Secret`: Partner secret key for authentication
* `merchant-key`: Identifies the target store

The API behavior is identical to a direct merchant integration — the partner headers simply associate the operation with the partner for tracking and reporting.

## Capabilities

| Action              | Endpoint                   | Description                                  |
| ------------------- | -------------------------- | -------------------------------------------- |
| Create order        | `POST /v1/orders`          | Process a payment on behalf of a store       |
| Create payment link | `POST /v1/links`           | Generate a shareable payment URL for a store |
| Get order           | `GET /v1/orders/{orderId}` | Check order status for a store's order       |

## Becoming a partner

Partner access is granted on a case-by-case basis. Contact [sales@wava.co](mailto:sales@wava.co) with details about your platform and expected transaction volume.

Upon approval, you will receive:

* **API Key** (`X-API-Key`): Your partner identifier
* **API Secret** (`X-API-Secret`): Your authentication secret

Both credentials must be included in every API request.