# 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.

The main path of a payment intent:

- `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

1. [Create your account](https://pay-docs.adpromax.com/en/get-started/create-account): the sandbox is ready as soon as you sign up.
2. Read [Your API keys](https://pay-docs.adpromax.com/en/get-started/api-keys) and send your first request.
3. Take a test card payment and a test cash payment: [card quickstart](https://pay-docs.adpromax.com/en/get-started/quickstart-card),
   [cash quickstart](https://pay-docs.adpromax.com/en/get-started/quickstart-cash).
4. [Test your integration](https://pay-docs.adpromax.com/en/get-started/test-your-integration), read
   [Sandbox and live: the differences](https://pay-docs.adpromax.com/en/sandbox/differences), then follow the
   [go-live checklist](https://pay-docs.adpromax.com/en/get-started/go-live).