Skip to main content

​
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

ActionEndpointDescription
Create orderPOST /v1/ordersProcess a payment on behalf of a store
Create payment linkPOST /v1/linksGenerate a shareable payment URL for a store
Get orderGET /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 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.