Flow documentation

Everything you need to integrate Flow — a checkout-as-a-service platform built for ambitious merchants in MENA. The platform handles gateway orchestration, 3DS, tokenization, refunds, and webhooks so you can focus on your product.

Where to start

Architecture in 30 seconds

1. Your server creates a checkout session via the API (uses your secret mp_test_* / mp_live_* key).
2. Your client (browser / iOS / Android) opens the hosted checkout using the returned sessionToken.
3. The customer completes payment on minnha's PCI-DSS SAQ-A page — card data never touches your code.
4. minnha sends a signed webhook to your server with the result (and invoice details when billing is enabled).
5. Your customer is redirected back to your successUrl / cancelUrl.

Quick links

• Creating sessions
• Educational billing & VAT invoices
• Receiving webhooks (with signature verification)
• Switching between TEST and LIVE
• Error handling