Vue d’ensemble

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’abordCopier le lien de la section

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 finCopier le lien de la section

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.

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 ensuiteCopier le lien de la section

1. Créez votre compte : le bac à sable est prêt dès l’inscription.
2. Lisez Vos clés d’API 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, démarrage rapide espèces.
4. Testez votre intégration, lisez Bac à sable et production : les différences, puis suivez la liste de contrôle avant la production.