For developers

Introduction for developers

This section covers everything you need to integrate with Solvimon: authentication, error handling, idempotency, webhooks, and HTTP conventions.

The four APIs

Solvimon exposes four separate APIs. Most integrations use all four.

APIBase pathWhat it’s for
Configuration API/v1/Create and manage meters, products, pricing plans, features
Identity API/v1/Create and manage customers, subscriptions
Transaction API/v1/Invoices, payments, credit notes
Event API/v1/Ingest usage events

Full endpoint reference is in the API Docs tab.

Environments

EnvironmentAPI base URLDesk URL
Testhttps://test.api.solvimon.com/v1/https://test.desk.solvimon.com
Productionhttps://api.solvimon.com/v1/https://desk.solvimon.com

Test and production are fully isolated. Test keys will not work against the production endpoint and vice versa. Data created in one environment never appears in the other.

Request conventions

Every request requires:

  • Content-Type: application/json
  • X-API-KEY: <your_key> — see Authentication
  • HTTPS — plain HTTP requests are rejected

Every response includes an X-REQUEST-ID header. Save this value when debugging; it’s required when contacting support about a specific request.

  1. Authentication — how to get and use your API key
  2. Errors — error codes and what they mean
  3. Idempotency — safely retrying requests
  4. Webhooks — receiving real-time event notifications