User-added image

Mada is Saudi Arabia’s domestic payment network, with over 30 million debit cards in circulation. Shoppers paying with Mada can complete their transaction from your checkout page without being redirected to a hosted payment page, providing a swift and familiar user experience.

 

This integration is only available in the legacy version of Checkout.com. To determine which version of Checkout.com you are using, see Connecting with Checkout.com.

 

How It Works

Once you’ve connected Mada with Checkout.com, shoppers meeting the requirements will see it displayed as an accepted card brand next to the gateway’s display name. Shoppers can enter their Mada payment information as they would for any other credit card to complete the transaction.

The Mada logo in Checkout.com's credit card payment method

Once the order has been placed, it will appear in your control panel as Credit card (via Checkout.com) in the Payment Method field. Orders placed using Mada share the same fulfillment process as typical orders.

An order placed with Mada

 

Requirements and Limitations

  • Your store must meet the following criteria:
    • Your store must be located in Saudi Arabia.
    • You must have SAR as an available transactional currency.
    • Your store must use Optimized One-Page Checkout.
  • Shopper Requirements
    • Shoppers must use an address in Saudi Arabia at checkout.
    • Shoppers must have SAR selected as their transaction currency.
    • Shoppers must authenticate via 3D Secure during checkout, even when 3D Secure is disabled in Checkout.com.
  • Limitations
    • Delayed capture is not supported.
    • Transactions cannot be voided, as capture occurs immediately after authorization.
 

Supported Gateways

Checkout.com

See Connecting with Checkout.com for documentation on features, requirements, and setup.

  • Additional Setup
    • Mada is only available in the legacy version of Checkout.com. See the FAQ for more information.
    • Contact your Checkout.com Customer Success Manager or reach out to Checkout.com Support to enable Mada on your Checkout.com account.
    • Toggle Enable Mada Cards in Checkout.com Settings within your BigCommerce control panel.
 

FAQ

Why is Mada not displayed as an available credit card option at checkout?

If your shoppers meet the above requirements and still do not see the Mada logo next to the payment gateway at checkout, check the Accepted Cards field in the Checkout.com Settings in the BigCommerce control panel to ensure that Mada is enabled.

Can Mada be tested in Sandbox/Test Mode?

Yes, by using the following test card credentials as a "mock" Mada card:

  • Number: 5199992312641465
  • CVV: 010

Can I accept Mada payments after upgrading to the latest version of Checkout.com?

If you’ve upgraded your Checkout.com integration, Mada cards can no longer be used in the Credit/Debit Card payment method at checkout. However, Checkout.com’s Apple Pay payment method allows shoppers to select a Mada card for payment when using the digital wallet.

 

Additional Resources