> For the complete documentation index, see [llms.txt](https://docs.intram.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intram.org/merchant-api-v1/changelog.md).

# Changelog

## v1.0 — 2026-05-20 (initial)

Première version publique du Merchant API.

### Ajouts

* `GET /balance` — solde wallet sync
* `POST /payouts` — reversements mobile money + bank wire (async)
* `POST /payment-requests` — demandes de paiement avec `gateway_url` (async)
* `POST /refunds` — refunds mobile money + Stripe (async)
* `GET /transactions/:reference` + `GET /transactions` — statut + historique
* `GET /operations/:id` + `GET /operations` — suivi des opérations asynchrones
* `GET/POST/DELETE /webhooks` + `POST /webhooks/:subscription_id/test` — gestion des souscriptions
* Webhooks sortants signés HMAC-SHA256 avec retry exponentiel (1m / 5m / 30m / 2h / 12h)
* Whitelist IP obligatoire en mode live (gérée depuis le dashboard)
* Idempotency-Key obligatoire sur toutes les mutations (TTL 24h)

### Compatibilité

Aucune modification des routes existantes `/api/v1/payments/*`, `/refund/*`, `/recharges/*`, `/widget/*`, `/webhook/*`. Le Merchant API v1 vit sous `/api/v1/merchant/*` (URL publique `api.intram.org/v1/*` après rewrite Nginx).

## Politique de versioning

* **Patch / additions non-breaking** : nouveaux endpoints, nouveaux champs en réponse, nouveaux events webhook → pas de bump de version, annoncé ici.
* **Breaking changes** : changement de signature, suppression de champ, changement de comportement → nouveau path `/v2/`, l'ancien reste maintenu **au minimum 12 mois** après l'annonce, période pendant laquelle les deux coexistent.
* Les `code` JSON d'erreur sont **stables** à l'intérieur d'une version majeure. Les `message` peuvent évoluer (traductions, reformulations).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intram.org/merchant-api-v1/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.