Kesles Merchant Developer Documentation
Welcome to the official Kesles Merchant documentation. This documentation is intended for:
- Business Partners (resellers, agencies, affiliates, communities, sales) who integrate their systems with Kesles merchants for referral attribution, transaction reporting, or commission tracking
- Merchant Developers building integrations on top of the Kesles merchant API (mobile app, dashboard, accounting integration)
For other types of server-to-server integration outside the two audiences above, Kesles provides a separate API contract shared directly with the integration PIC via the Partner Agreement — that documentation is not public. Contact the Kesles integration team for details.
What's in Here
| Section | Contents |
|---|---|
| Getting Started | Initial setup, basic authentication, partner onboarding |
| Guides | HMAC authentication for server-to-server endpoints |
| API Reference | Endpoint specifications: Merchants API, Partner API |
Integration Principles
- HTTPS always — all public endpoints only accept requests via TLS 1.2+
- Idempotent — use
X-Idempotency-Keyfor retryable write operations - Traceable — every request must include
X-Request-ID(UUID v4) for debugging - Secure — credentials (API key, HMAC secret) must never end up in the browser / public source code
Next Steps
- Just starting? → Getting Started
- New partner? → Partner Onboarding
- Already know the basics? → HMAC Authentication Guide
- Looking for a specific endpoint? → API Reference