Developer platform

Build on Madfoa

A documented, predictable API surface for payment acceptance and merchant operations — with client SDKs, real-time webhooks and a sandbox to build against with confidence.

Illustrative examples

Code samples and endpoints on these pages are illustrative and point at the sandbox. Production access, credentials and available capabilities are provisioned per engagement — talk to our team to get started.

Quickstart

Authentication

Authenticate requests with API keys and bearer tokens.

Open

Sandbox

Test end to end before you go live.

Open

API reference

Endpoints, parameters and responses.

Open

Webhooks

Receive real-time transaction events.

Open

Create a payment

A minimal request creates a payment against a merchant in the sandbox. Authenticate with a bearer token, send an amount in the smallest currency unit, and reference the merchant you are transacting for.

curl https://sandbox.api.madfoa.com/v1/payments \
  -H "Authorization: Bearer $MADFOA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4500,
    "currency": "SAR",
    "merchant_id": "mch_08c1a2",
    "method": "card"
  }'

Principles

Sandbox-first. Validate integrations safely before going live.
Documented and versioned. Predictable contracts your team can build on.
Server-to-server. Direct integration into merchant and provider systems.
Event-driven. Webhooks keep your systems in sync in real time.

Next: Authentication →