Cards · MENA
Accept Mada payments
Saudi Arabia's domestic debit scheme, mandatory for local card acceptance and routed for the best domestic rate.
The facts
How Mada behaves on the rail.
- Flow
- Hosted fields
- Direction
- Pull — you request the funds
- Settlement
- T+1 to T+2
- Refunds
- Full and partial
- Recurring
- Supported
- Currencies
- SAR
- Regions
- MENA
In code
One request, this method.
Set payment_method.type to "card" and the same payment object, events and portal apply.
# 1. Tokenise (hosted fields do this in the browser; the sandbox tokenizer stands in for a test)
curl https://cleared-pay.com/api/v1/sandbox/tokens \
-H "Authorization: Bearer cp_sk_test_..." -H "Content-Type: application/json" \
-d '{"type":"card","number":"4242424242424242","exp_month":12,"exp_year":2031,"cvc":"123"}'
# 2. Create the payment with the token
curl https://cleared-pay.com/api/v1/payments \
-H "Authorization: Bearer cp_sk_test_..." -H "Content-Type: application/json" \
-H "Idempotency-Key: 6d2e4a1c-8f7b-4a9d-b3c5-2e1f0a9b8c7d" \
-d '{"amount":2000,"currency":"sar","reference":"ORDER-10432","payment_method":{"type":"card","token":"tok_..."},"return_url":"https://merchant.example/return"}'Related
More in cards.
Talk to us about enabling Mada.
Tell us the markets, volumes and currencies, and we will say what we can do and when.