# INTRODUCTION

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


---

# Agent Instructions: 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/readme.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.