# AdProMaxPay Docs

> Accept cards and cash in Morocco with one API: guides, quickstarts and the API reference.

## Français

- [Sécurité](https://pay-docs.adpromax.com/fr/account/security.md): Protégez votre compte, vos clés d’API et vos secrets de webhook : vérification en deux étapes, renouvellement et révocation des clés, et que faire après une fuite.
- [Équipe et rôles](https://pay-docs.adpromax.com/fr/account/team-and-roles.md): Invitez les personnes qui travaillent avec vous, donnez un rôle à chacune, et voyez ce que chaque rôle permet.
- [Idempotence](https://pay-docs.adpromax.com/fr/api-reference/idempotency.md): Renvoyer une requête sans l’exécuter deux fois. Quelles requêtes demandent une Idempotency-Key, et ce que l’API répond à une répétition.
- [Limites de débit](https://pay-docs.adpromax.com/fr/api-reference/rate-limits.md): Les compartiments de requêtes de votre organisation, les en-têtes RateLimit, la gestion d’un 429, et comment demander une limite plus haute.
- [Journal des modifications](https://pay-docs.adpromax.com/fr/changelog.md): Chaque version de l’API AdProMaxPay, ce qu’elle contient, et si elle casse du code existant.
- [Gérer les erreurs](https://pay-docs.adpromax.com/fr/errors.md): L’objet d’erreur, les sept types d’erreur, les codes que vous rencontrerez d’abord, et comment traiter chacun.
- [Vue d’ensemble](https://pay-docs.adpromax.com/fr/get-started.md): Ce que fait AdProMaxPay, le fonctionnement du bac à sable, et le chemin d’un premier paiement de test jusqu’à la production.
- [Vos clés d’API](https://pay-docs.adpromax.com/fr/get-started/api-keys.md): Clés de test et de production, secrètes et publiables, et votre première requête authentifiée.
- [Créer un compte](https://pay-docs.adpromax.com/fr/get-started/create-account.md): Inscrivez-vous, recevez votre organisation et ses clés de test, et repérez-vous dans le bac à sable.
- [Liste de contrôle avant la production](https://pay-docs.adpromax.com/fr/get-started/go-live.md): Comment l’activation ouvrira les paiements réels, ce qu’il faut préparer, et ce qu’il faut vérifier avant de passer des clés de test aux clés de production.
- [Démarrage rapide : paiement par carte avec la page hébergée](https://pay-docs.adpromax.com/fr/get-started/quickstart-card.md): Créez une session de paiement, payez-la avec une carte de test et apprenez le résultat par un webhook. Une dizaine de minutes, en mode test.
- [Démarrage rapide : paiement en espèces](https://pay-docs.adpromax.com/fr/get-started/quickstart-cash.md): Donnez à votre client un code qu’il paie en espèces, simulez le paiement en mode test et apprenez le résultat par un webhook.
- [Tester votre intégration](https://pay-docs.adpromax.com/fr/get-started/test-your-integration.md): Chaque parcours possible de vos clients, chaque échec et le traitement de vos webhooks, testés de bout en bout dans le bac à sable avant la production.
- [Paiements par carte](https://pay-docs.adpromax.com/fr/payments/card-payments.md): Le déroulement d’un paiement par carte, 3-D Secure, les refus et les nouvelles tentatives, et comment envoyer votre client sur la page carte depuis votre propre page.
- [Paiements en espèces](https://pay-docs.adpromax.com/fr/payments/cash-payments.md): Les bons, le montant à payer, les échéances, le minimum de 100 MAD, où vos clients paient, et que faire quand un code expire.
- [Clients](https://pay-docs.adpromax.com/fr/payments/customers.md): Enregistrez qui vous paie, reliez ses paiements à lui, et retrouvez-le par son e-mail.
- [Page de paiement hébergée](https://pay-docs.adpromax.com/fr/payments/hosted-checkout.md): Une page de paiement que nous hébergeons pour la carte et les espèces, à vos couleurs. Créer une session de paiement, ce que voit votre client, et comment une session se termine.
- [Le fonctionnement des paiements](https://pay-docs.adpromax.com/fr/payments/how-payments-work.md): Intentions de paiement, tentatives, les statuts que traverse un paiement, et le signal auquel se fier avant de livrer.
- [Métadonnées](https://pay-docs.adpromax.com/fr/payments/metadata.md): Ajoutez vos propres références aux paiements, sessions, clients et remboursements, et retrouvez-les dans les webhooks et sur le tableau de bord.
- [Remboursements](https://pay-docs.adpromax.com/fr/payments/refunds.md): Rembourser un paiement par carte en totalité ou en partie, le temps que prend un remboursement, et pourquoi un paiement en espèces n’est pas remboursé en espèces.
- [Scénarios de test en espèces](https://pay-docs.adpromax.com/fr/sandbox/cash-scenarios.md): Payez, faites expirer, refusez ou suspendez un code espèces de test, et voyez comment votre intégration réagit à chaque issue.
- [Bac à sable et production : les différences](https://pay-docs.adpromax.com/fr/sandbox/differences.md): Le mode test exécute le même code que la production. Chaque différence voulue, avec sa valeur et sa raison.
- [Cartes de test](https://pay-docs.adpromax.com/fr/sandbox/test-cards.md): Des numéros de carte qui réussissent, sont refusés, demandent le 3-D Secure ou répondent tard sur la page de paiement simulée du mode test.
- [API des assistants de test](https://pay-docs.adpromax.com/fr/sandbox/test-helpers.md): Jouez le rôle du payeur depuis vos propres tests, sans navigateur : terminer un paiement par carte, payer ou faire expirer un code espèces.
- [Les webhooks en bref](https://pay-docs.adpromax.com/fr/webhooks.md): Comment AdProMaxPay informe votre serveur de ce qui s’est passé, comment configurer un endpoint, et les événements que vous pouvez recevoir.
- [Nouvelles tentatives, ordre et déduplication](https://pay-docs.adpromax.com/fr/webhooks/retries.md): Les livraisons arrivent au moins une fois et sans ordre garanti. Comment marchent les nouvelles tentatives, et comment traiter chaque événement une seule fois.
- [Vérifier les signatures](https://pay-docs.adpromax.com/fr/webhooks/signatures.md): Vérifiez qu’une livraison vient de AdProMaxPay et n’a été ni modifiée ni rejouée, dans dix langages.

## English

- [Security](https://pay-docs.adpromax.com/en/account/security.md): Protect your account, your API keys and your webhook secrets: two-step verification, rolling and revoking keys, and what to do after a leak.
- [Team and roles](https://pay-docs.adpromax.com/en/account/team-and-roles.md): Invite the people who work with you, give each one a role, and see what every role can do.
- [Idempotency](https://pay-docs.adpromax.com/en/api-reference/idempotency.md): Send a request again without doing it twice. Which requests need an Idempotency-Key, and what the API answers to a repeat.
- [Rate limits](https://pay-docs.adpromax.com/en/api-reference/rate-limits.md): The request buckets of your organization, the RateLimit headers, handling a 429, and how to ask for a higher limit.
- [Changelog](https://pay-docs.adpromax.com/en/changelog.md): Every version of the AdProMaxPay API, what it holds, and whether it breaks existing code.
- [Handling errors](https://pay-docs.adpromax.com/en/errors.md): The error object, the seven error types, the codes you meet first, and how to handle each.
- [Overview](https://pay-docs.adpromax.com/en/get-started.md): What AdProMaxPay does, how the sandbox works, and the path from a first test payment to going live.
- [Your API keys](https://pay-docs.adpromax.com/en/get-started/api-keys.md): Test and live keys, secret and publishable, and your first authenticated request.
- [Create an account](https://pay-docs.adpromax.com/en/get-started/create-account.md): Sign up, get your organization and its test keys, and find your way around the sandbox.
- [Go-live checklist](https://pay-docs.adpromax.com/en/get-started/go-live.md): How activation will open live payments, what to prepare, and what to check before you switch from test keys to live keys.
- [Quickstart: card payments with hosted checkout](https://pay-docs.adpromax.com/en/get-started/quickstart-card.md): Create a checkout session, pay it with a test card, and learn the result from a webhook. About ten minutes, in test mode.
- [Quickstart: cash payments](https://pay-docs.adpromax.com/en/get-started/quickstart-cash.md): Give your customer a payment code they pay in cash, simulate the payment in test mode, and learn the result from a webhook.
- [Test your integration](https://pay-docs.adpromax.com/en/get-started/test-your-integration.md): Every path your customers can take, each failure, and your webhook handling, tested end to end in the sandbox before you go live.
- [Card payments](https://pay-docs.adpromax.com/en/payments/card-payments.md): How a card payment works, 3-D Secure, declines and retries, and how to send your customer to the card page from your own page.
- [Cash payments](https://pay-docs.adpromax.com/en/payments/cash-payments.md): Vouchers, the amount to pay, deadlines, the 100 MAD minimum, where your customers pay, and what to do when a code expires.
- [Customers](https://pay-docs.adpromax.com/en/payments/customers.md): Record who pays, link their payments to them, and find them again by email.
- [Hosted checkout](https://pay-docs.adpromax.com/en/payments/hosted-checkout.md): A payment page we host for card and cash, in your colours. How to create a checkout session, what your customer sees, and how a session ends.
- [How payments work](https://pay-docs.adpromax.com/en/payments/how-payments-work.md): Payment intents, attempts, the statuses a payment goes through, and which signal to trust before you deliver.
- [Metadata](https://pay-docs.adpromax.com/en/payments/metadata.md): Attach your own references to payments, sessions, customers and refunds, and find them again in webhooks and on the dashboard.
- [Refunds](https://pay-docs.adpromax.com/en/payments/refunds.md): Refund a card payment in full or in part, how long a refund takes, and why a cash payment is not refunded in cash.
- [Test cash scenarios](https://pay-docs.adpromax.com/en/sandbox/cash-scenarios.md): Pay, expire, refuse or suspend a test cash code, and see how your integration reacts to each outcome.
- [Sandbox and live: the differences](https://pay-docs.adpromax.com/en/sandbox/differences.md): Test mode runs the same code as live mode. Every intentional difference, with its value and its reason.
- [Test cards](https://pay-docs.adpromax.com/en/sandbox/test-cards.md): Card numbers that succeed, decline, ask for 3-D Secure or answer late on the simulated payment page of test mode.
- [Test helpers API](https://pay-docs.adpromax.com/en/sandbox/test-helpers.md): Play the payer's part from your own tests, without a browser: complete a card payment, pay or expire a cash code.
- [Webhooks overview](https://pay-docs.adpromax.com/en/webhooks.md): How AdProMaxPay tells your server what happened, how to set up an endpoint, and the events you can receive.
- [Retries, ordering and deduplication](https://pay-docs.adpromax.com/en/webhooks/retries.md): Deliveries arrive at least once and in no guaranteed order. How retries work, and how to handle each event once.
- [Verifying signatures](https://pay-docs.adpromax.com/en/webhooks/signatures.md): Check that a delivery comes from AdProMaxPay and was not changed or replayed, in ten languages.

## العربية

- [الأمان](https://pay-docs.adpromax.com/ar/account/security.md): احمِ حسابك ومفاتيح API وأسرار الـ webhook: التحقق بخطوتين، وتجديد المفاتيح وإبطالها، وما عليك فعله بعد تسرّب.
- [الفريق والأدوار](https://pay-docs.adpromax.com/ar/account/team-and-roles.md): ادعُ الأشخاص الذين يعملون معك، وامنح كلًّا منهم دورًا، واطّلع على ما يستطيعه كل دور.
- [عدم التكرار](https://pay-docs.adpromax.com/ar/api-reference/idempotency.md): أرسل طلبًا من جديد دون أن يُنفَّذ مرتين. أي الطلبات تحتاج إلى Idempotency-Key، وما تجيب به واجهة API عند التكرار.
- [حدود المعدل](https://pay-docs.adpromax.com/ar/api-reference/rate-limits.md): فئات الطلبات في مؤسستك، وترويسات RateLimit، ومعالجة 429، وكيف تطلب حدًا أعلى.
- [سجل التغييرات](https://pay-docs.adpromax.com/ar/changelog.md): كل إصدارات API لدى AdProMaxPay، وما يتضمنه كل إصدار، وهل يكسر الكود القائم.
- [معالجة الأخطاء](https://pay-docs.adpromax.com/ar/errors.md): كائن الخطأ، وأنواع الأخطاء السبعة، والرموز التي تصادفها أولًا، وكيف تعالج كلًّا منها.
- [نظرة عامة](https://pay-docs.adpromax.com/ar/get-started.md): ما يقدمه AdProMaxPay، وكيف تعمل بيئة الاختبار، والطريق من أول دفعة اختبار إلى الوضع المباشر.
- [مفاتيح API الخاصة بك](https://pay-docs.adpromax.com/ar/get-started/api-keys.md): مفاتيح الاختبار ومفاتيح الوضع المباشر، السرية والقابلة للنشر، وأول طلب مصادَق عليه ترسله.
- [إنشاء حساب](https://pay-docs.adpromax.com/ar/get-started/create-account.md): سجّل، واحصل على مؤسستك ومفاتيح الاختبار الخاصة بها، وتعرّف على بيئة الاختبار.
- [قائمة التحقق قبل الوضع المباشر](https://pay-docs.adpromax.com/ar/get-started/go-live.md): كيف سيفتح التفعيل المدفوعات الحقيقية، وما الذي تجهّزه، وما الذي تتحقق منه قبل التبديل من مفاتيح الاختبار إلى مفاتيح الوضع المباشر.
- [البدء السريع: الدفع بالبطاقة عبر صفحة الدفع المستضافة](https://pay-docs.adpromax.com/ar/get-started/quickstart-card.md): أنشئ جلسة دفع، وادفعها ببطاقة اختبار، واعرف النتيجة من webhook. نحو عشر دقائق، في وضع الاختبار.
- [البدء السريع: الدفع نقدًا](https://pay-docs.adpromax.com/ar/get-started/quickstart-cash.md): امنح عميلك رمز دفع يسدده نقدًا، وحاكِ الدفع في وضع الاختبار، واعرف النتيجة من webhook.
- [اختبر تكاملك](https://pay-docs.adpromax.com/ar/get-started/test-your-integration.md): كل مسار قد يسلكه عملاؤك، وكل حالة فشل، ومعالجتك لإشعارات webhook، مختبرة من البداية إلى النهاية في بيئة الاختبار قبل الانتقال إلى الوضع المباشر.
- [الدفع بالبطاقة](https://pay-docs.adpromax.com/ar/payments/card-payments.md): كيف تعمل الدفعة بالبطاقة، و3-D Secure، وحالات الرفض وإعادة المحاولة، وكيف ترسل عميلك إلى صفحة البطاقة من صفحتك الخاصة.
- [الدفع نقدًا](https://pay-docs.adpromax.com/ar/payments/cash-payments.md): القسائم، والمبلغ الواجب دفعه، والآجال، والحد الأدنى 100 MAD، وأين يدفع عملاؤك، وما تفعله عند انتهاء صلاحية رمز.
- [العملاء](https://pay-docs.adpromax.com/ar/payments/customers.md): سجّل من يدفع، واربط مدفوعاته به، واعثر عليه من جديد ببريده الإلكتروني.
- [صفحة الدفع المستضافة](https://pay-docs.adpromax.com/ar/payments/hosted-checkout.md): صفحة دفع نستضيفها للبطاقة والنقد، بألوانك. كيف تنشئ جلسة دفع، وما يراه عميلك، وكيف تنتهي الجلسة.
- [كيف تعمل المدفوعات](https://pay-docs.adpromax.com/ar/payments/how-payments-work.md): نيات الدفع والمحاولات، والحالات التي تمر بها الدفعة، والإشارة التي تثق بها قبل تسليم الطلبية.
- [البيانات الوصفية](https://pay-docs.adpromax.com/ar/payments/metadata.md): أرفق مراجعك الخاصة بالمدفوعات والجلسات والعملاء وعمليات الاسترداد، واعثر عليها من جديد في إشعارات webhook وفي لوحة التحكم.
- [المبالغ المستردة](https://pay-docs.adpromax.com/ar/payments/refunds.md): استرداد دفعة بالبطاقة كليًا أو جزئيًا، والمدة التي يستغرقها الاسترداد، ولماذا لا تُسترد الدفعة النقدية نقدًا.
- [سيناريوهات اختبار الدفع النقدي](https://pay-docs.adpromax.com/ar/sandbox/cash-scenarios.md): ادفع رمز دفع نقدي للاختبار، أو أنهِ صلاحيته، أو ارفضه، أو علّقه، وشاهد كيف يتفاعل تكاملك مع كل نتيجة.
- [بيئة الاختبار والوضع المباشر: الفروق](https://pay-docs.adpromax.com/ar/sandbox/differences.md): يشغّل وضع الاختبار الكود نفسه الذي يشغّله الوضع المباشر. إليك كل فرق مقصود، مع قيمته وسببه.
- [بطاقات الاختبار](https://pay-docs.adpromax.com/ar/sandbox/test-cards.md): أرقام بطاقات تنجح أو تُرفض أو تطلب 3-D Secure أو تجيب متأخرة في صفحة الدفع المحاكاة في وضع الاختبار.
- [واجهة API لأدوات الاختبار المساعدة](https://pay-docs.adpromax.com/ar/sandbox/test-helpers.md): أدِّ دور الدافع من اختباراتك الخاصة، دون متصفح: أكمل دفعة بالبطاقة، وادفع رمز دفع نقدي أو أنهِ صلاحيته.
- [نظرة عامة على Webhooks](https://pay-docs.adpromax.com/ar/webhooks.md): كيف يخبر AdProMaxPay خادمك بما حدث، وكيف تضبط نقطة استقبال، والأحداث التي يمكنك تلقيها.
- [إعادة المحاولة والترتيب وإزالة التكرار](https://pay-docs.adpromax.com/ar/webhooks/retries.md): تصل عمليات التسليم مرة واحدة على الأقل، ودون ترتيب مضمون. كيف تعمل إعادة المحاولة، وكيف تعالج كل حدث مرة واحدة.
- [التحقق من التوقيعات](https://pay-docs.adpromax.com/ar/webhooks/signatures.md): تأكد من أن عملية التسليم صادرة عن AdProMaxPay ولم تُعدَّل ولم يُعَد إرسالها، بعشر لغات.