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 Flow's PCI-DSS SAQ-A page — card data never touches your code.
  4. Flow 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.

Prefer to draw your own method picker? The same session can be paid through the API alone: see Ways to integrate.

Where it runs

Flow runs in Saudi Arabia, on Google Cloud's Dammam region: the API, the database, the hosted checkout and the model that reads documents all stay in the Kingdom. Production is api.flow.minnha.sa and pay.flow.minnha.sa; the UAT stack is listed under Environments.

Quick links