> 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/readme.md).

# INTRODUCTION

Introduction à l'intégration de l'API Intram.

Cette documentation vous accompagne dans l'intégration des solutions Intram dans vos applications web, mobiles et serveurs.

## Vue d'ensemble des APIs

Intram propose **deux interfaces** complémentaires que vous pouvez utiliser selon votre besoin :

| Interface                                                  | À utiliser pour                                                                                                     | Documentation                                                                                 |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| **API publique de paiement** (legacy)                      | Construire un checkout client : pages widget, SDK JavaScript, plugins WordPress/Django/PHP                          | [HTTP](https://docs.intram.org/backend/http.md), [SDKs](https://docs.intram.org/api-index.md) |
| **Merchant API v1** (nouveau, recommandée pour le backend) | Piloter votre compte marchand depuis votre backend : solde, payouts, demandes de paiement, refunds, webhooks signés | [Merchant API](https://docs.intram.org/merchant-api-v1/merchant-api.md)                       |

Les deux coexistent sans interférer. Choisissez la première si vous voulez encaisser un paiement client ; la seconde si vous voulez automatiser la gestion de votre compte depuis vos propres serveurs.

## Pré-requis

Avant toute intégration vous avez besoin :

1. **D'un compte Intram validé** — [inscrivez-vous](https://app.intram.org/register) puis suivez la procédure d'[activation du compte marchand](https://docs.intram.org/account/account-activation.md).
2. **D'au moins un compte business** validé (Paramètres → Compte business).
3. **De vos clés API** — générées automatiquement pour chaque environnement (sandbox + live).

## Récupérer vos clés API

1. **Connectez-vous** à <https://app.intram.org/login> avec vos identifiants marchands.
2. Dans le menu de gauche, cliquez sur **Développeurs**.
3. Cliquez ensuite sur **API**.
4. Le tableau de bord affiche trois clés, par environnement (`SANDBOX` ou `LIVE`) :
   * **Clé API publique** (`public_key`) — identifiant non secret de votre compte
   * **Clé API privée** (`private_key`) — utilisée par les anciennes intégrations SDK
   * **Clé API secrète** (`secret_key`) — **ne sort jamais** ; utilisée pour signer les requêtes Merchant API et vérifier les webhooks

{% hint style="info" %}
Commencez toujours par développer en `SANDBOX`. Les transactions sandbox ne touchent pas l'argent réel et permettent de tester librement vos flows. Passez en `LIVE` quand votre intégration est stable.
{% endhint %}

{% hint style="danger" %}
Ne partagez jamais vos clés `private_key` et `secret_key` — pas dans un dépôt Git public, pas dans le code front-end, pas dans les logs. Si une clé est compromise, régénérez-la immédiatement depuis le dashboard.
{% endhint %}

## Par où commencer

| Vous voulez…                                                          | Direction                                                                                                                        |
| --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Créer un compte                                                       | [Inscription](https://docs.intram.org/account/register.md) → [Activation](https://docs.intram.org/account/account-activation.md) |
| Encaisser sans site web avec un lien à partager                       | [Intram Direct](https://docs.intram.org/modules/intram-direct.md)                                                                |
| Gérer un catalogue d'offres + clients + abonnements                   | [Intram Business](https://docs.intram.org/modules/intram-business.md)                                                            |
| Encaisser des paiements depuis votre site (page checkout)             | [SDKs frontend / backend](https://docs.intram.org/api-index.md) ou [HTTP direct](https://docs.intram.org/backend/http.md)        |
| Piloter votre compte (payouts, balance, refunds) depuis votre backend | [Merchant API v1 — Quickstart](https://docs.intram.org/merchant-api-v1/quickstart.md)                                            |
| Encaisser des paiements depuis votre app mobile                       | [Flutter](https://docs.intram.org/mobile/flutter.md)                                                                             |
| Comprendre les frais appliqués                                        | [Frais](https://docs.intram.org/payment/fees.md)                                                                                 |
| Connaître les devises et moyens de paiement supportés                 | [Devises supportées](https://docs.intram.org/payment/supported-devices.md)                                                       |
