# Vue d’ensemble

Ce que fait AdProMaxPay, le fonctionnement du bac à sable, et le chemin d’un premier paiement de test jusqu’à la production.

AdProMaxPay permet à une entreprise au Maroc d’encaisser des paiements en ligne avec une seule API, en
dirhams marocains (MAD) :

* **Paiements par carte**, sur une page de paiement hébergée : votre client quitte votre site pour
  payer, puis y revient.
* **Paiements en espèces** : votre client reçoit un code de paiement et le règle en espèces chez un
  agent de paiement.

Vous créez un paiement, envoyez votre client payer, et apprenez le résultat par un webhook. Le même
code sert pour les deux moyens de paiement.

## Le bac à sable d’abord

Chaque compte commence dans le **bac à sable**. Vous recevez tout de suite des clés de test, et le
mode test simule les paiements par carte et en espèces de bout en bout : aucun argent réel ne
circule et rien n’atteint une banque. Quand votre intégration fonctionne, vous demandez l’activation ;
une fois votre compte actif, les clés de production encaissent de vrais paiements avec le même code.

Le test et la production sont deux **modes** distincts. Chacun a ses clés et ses données : un
paiement de test n’apparaît jamais en production, et inversement.

## Un paiement, du début à la fin

Un paiement est une **intention de paiement** (*payment intent*). Elle passe par quelques états, et
votre code lit l’état au lieu de le deviner.

Le parcours principal d’une intention de paiement:

- `requires_payment_method` → `requires_action`: page carte ou code espèces
- `requires_action` → `processing`: le client a payé
- `processing` → `succeeded`: paiement confirmé
- `requires_payment_method` → `canceled`: annulé ou expiré

Une carte refusée ou un code espèces expiré ramène le paiement à `requires_payment_method`, et votre
client peut réessayer. Un paiement réussit une seule fois, et seulement après confirmation du
paiement et vérification du montant.

## Et ensuite

1. [Créez votre compte](https://pay-docs.adpromax.com/fr/get-started/create-account) : le bac à sable est prêt dès l’inscription.
2. Lisez [Vos clés d’API](https://pay-docs.adpromax.com/fr/get-started/api-keys) et envoyez votre première requête.
3. Faites un paiement de test par carte et un paiement de test en espèces :
   [démarrage rapide carte](https://pay-docs.adpromax.com/fr/get-started/quickstart-card),
   [démarrage rapide espèces](https://pay-docs.adpromax.com/fr/get-started/quickstart-cash).
4. [Testez votre intégration](https://pay-docs.adpromax.com/fr/get-started/test-your-integration), lisez
   [Bac à sable et production : les différences](https://pay-docs.adpromax.com/fr/sandbox/differences), puis suivez la
   [liste de contrôle avant la production](https://pay-docs.adpromax.com/fr/get-started/go-live).