Morocco · MAD
Card · Cash
Payments for Morocco, by card and in cash
One account to take card payments and cash payments at an agent, in dirhams. Test everything in the sandbox first.
In every account
- Card
- Cash at an agent
- Payment links
- Hosted checkout
- API
- Signed webhooks
- Test mode
- Refunds
- Balances
- MAD
I. What it is
One account to get paid in Morocco: by card on a secure page, or in cash at an agent, with a link you share or an API you call.
AdProMaxPay is a payments platform for businesses in Morocco. Amounts are in dirhams. You start in a sandbox where no real money moves, and you go live once your business is approved. Payzone, a licensed payment institution, holds the funds and settles them to you.
- Ways to pay: card and cash
- 2
- Languages: French, Arabic, English
- 3
- Languages of code samples in the docs
- 10
- Lines of code for a payment link
- 0
II. Ways to get paid
Four ways in, one account
Pull a card from the shelf. Each one is a way to take a payment, in test mode first.
I. Card
Card payments
Your customer pays with a bank card on our payment partner’s secure page, then comes back to you. We never see the card number.
- Visa, Mastercard and Moroccan cards
- Protected by 3-D Secure
- Refunds from the dashboard, in full or in part
II. Cash at an agent
Cash, paid at an agent
Your customer receives a payment code and pays it in cash at a CashPlus agent within a few days. For customers with no card, or who prefer not to use one online.
- A code on a voucher to share or print
- Paid in cash at a CashPlus agent
- From 100 MAD
III. Payment links
Payment links, without code
A name, an amount, and a link you share by WhatsApp, by SMS or as a QR code. No website to build.
- Collect a name, a phone number or an email
- A message or a redirect after payment
- An end date or a maximum number of payments
IV. API
An API for your own site
Payment intents, checkout sessions, customers, refunds and events. The same code takes a card payment and a cash payment.
- Webhooks, signed and retried
- Idempotency keys on every request that moves money
- Code samples in 10 languages
III. How it works
From sign-up to your first live payment
Three steps. The first two happen in the sandbox, where no real money moves.
I.
Create your account
Sign up with your email. Your sandbox opens at once, with its test keys.
II.
Test in the sandbox
Take test payments by card and in cash. Try a decline, a delay, a refund. No real money moves.
III.
Activate and go live
Fill in the activation application: your business, its representative, a bank account, your documents. Our team reviews it, then Payzone approves it, and live mode opens.
IV. For developers
An API that tells you what happened
Create a payment, send your customer to pay, and learn the outcome from a webhook. Every error has a code, and every code has its page in the docs.
curl https://pay-api.adpromax.com/v1/payment_intents \
-u "$APX_SECRET_KEY:" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 8e0d2c5e-4f3a-4b8e-9c71-2a6f0d3b5e14" \
-d '{"amount": 25000, "currency": "mad",
"payment_method_types": ["card", "cash"]}'
From the docs, where the same sample is written in 10 languages.
Three test cards
- 4242 4242 4242 4242Succeeds
- 4000 0000 0000 32203-D Secure
- 4000 0000 0000 0002Declined
Signed webhooks
Each delivery carries a signature your server checks, and is sent again when your server does not answer.
Test cards and cash helpers
A card that succeeds, one that asks for 3-D Secure, one that is declined. A cash code you pay, expire or refuse yourself.
Idempotency keys
Send a request again after a network failure without making a second payment.
V. The dashboard
Every payment, with its story
Payments with their timeline, customers, refunds, balances, your team and its roles, API keys, webhooks, events and request logs: one place for the people who run the business and the people who build it.
VI. Security
Security, in plain words
What protects your account and your customers, without the jargon.
Two-factor sign-in
A code from your phone, on top of your password.
Roles and permissions
Each person on your team sees and does only what their role allows.
An audit journal
Who did what, and when, is written down.
Keys shown once
A secret key is displayed when it is created, and never again.
Signed webhooks
Your server can check that a notification really comes from us.
No card number reaches us
Card details are typed on our payment partner’s secure page. We never see them.
Who holds the money?
Payzone, a licensed payment institution, holds the funds and settles merchants. The balances in your dashboard are a ledger of record: what is pending, and what is available.
VII. Questions
Asked before signing up
Short answers. The docs hold the long ones.
Payzone, a licensed payment institution, holds the funds and settles merchants. AdProMaxPay does not hold your money: the balances in your dashboard, pending and available, are a ledger of record of what is owed to you.
Fill in the activation application in your dashboard: your business, its representative, a bank account and your documents. Our team reviews it, then Payzone approves it, and live mode opens. Until then you work in the sandbox.
Pricing is agreed with each business at activation. We do not publish a price list: talk to us and we will go through it together. The sandbox is open to every account.
Visa, Mastercard and Moroccan bank cards. Payments are protected by 3-D Secure, and the card is typed on our payment partner’s secure page.
Your customer receives a payment code and pays it in cash at a CashPlus agent within a few days. You are told when it is paid. A cash payment starts at 100 MAD.
Yes. Every account starts in test mode, kept apart from live: test cards, simulated cash payments and sample data in one click. No real money moves.
French, Arabic and English: the dashboard, the hosted checkout page your customers see, and this site.
A card payment is refunded from the dashboard, in full or in part. A cash payment cannot be refunded through AdProMaxPay: you settle it with your customer directly.
No. Payment links and cash vouchers are made from the dashboard, without code. The API is there the day you want to connect your own site or app.
Moroccan dirhams (MAD) only.
Open your sandbox, take a test payment today
Nothing to install, and no real money moves in test mode.