Get started
Overview
What AdProMaxPay does, how the sandbox works, and the path from a first test payment to going live.
AdProMaxPay lets a business in Morocco accept payments online with one API, in Moroccan dirhams (MAD):
- Card payments, on a hosted payment page: your customer leaves your site to pay, then comes back.
- Cash payments: your customer receives a payment code and pays it in cash at a payment agent.
You create a payment, send your customer to pay, and learn the outcome from a webhook. The same code works for both methods.
The sandbox comes first
Every account starts in the sandbox. You get test keys at once, and test mode simulates card and cash payments end to end: no real money moves, and nothing reaches a bank. When your integration works, you ask for activation; once your account is active, live keys take real payments with the same code.
Test and live are two separate modes. Each has its own keys and its own data: a test payment is never visible in live mode, and the reverse.
A payment, from start to finish
A payment is a payment intent. It moves through a few states, and your code reads the state rather than guessing.
- requires_payment_method → requires_action: card page or cash code
- requires_action → processing: customer paid
- processing → succeeded: payment confirmed
- requires_payment_method → canceled: canceled or expired
A declined card or an expired cash code sends the payment back to requires_payment_method, and your
customer can try again. A payment succeeds once, and only after the payment is confirmed and the
amount matches.
Where to go next
- Create your account: the sandbox is ready as soon as you sign up.
- Read Your API keys and send your first request.
- Take a test card payment and a test cash payment: card quickstart, cash quickstart.
- Test your integration, read Sandbox and live: the differences, then follow the go-live checklist.