Mada

Copy page

Copy page as Markdown for LLMs

Open in ChatGPT

Ask questions about this page

Open in Claude

Ask questions about this page

Mada is a national payment network in Saudi Arabia, managed by the Saudi Central Bank (SAMA). It's essentially the domestic debit card system in the Kingdom, similar to how Visa or Mastercard work internationally.

No special integration is required to support Mada. It functions the same way as Visa and Mastercard. As long as Mada is activated on your account, it will be automatically supported through any of our integration types, however it is mandatory to implement Mada branding on your checkout and it should be compliant with Mada branding guidelines.

Mada does not support Authorization command and does not allow downgrading the 3DS.

Prerequisites

Before implementing Mada payments, ensure you have:

1. Active Mada Service
   Mada must be activated on your Amazon Payment Services account. Contact your account manager if you need activation.

2. Branding Compliance
   Mada branding implementation is a legal requirement in KSA enforced by SAMA. Non-compliance can disrupt payment processing.

3. Integration Method
   Choose your preferred integration approach - all methods support Mada automatically once activated.

Mada Branding Guidelines

Mada branding is a legal requirement in KSA enforced by SAMA. Failing to adhere to these guidelines can cause disruption to payment processing.

Implementation Steps

1

Choose Display Method

Decide how you want to display Mada in your checkout:

Option 1: Separate Mada Option

• Display Mada as a distinct payment method
• Include appropriate text labels
• Add Mada logo next to the option

Option 2: Combined with Other Cards

• Display Mada logo alongside Visa/Mastercard
• No text labels required
• Follow positioning guidelines

2

Apply Text Labels (If Separating Options)

Use the correct text labels for each language:

English

Display Text: mada bank card / Credit card

Arabic

Display Text: بطاقة مدى البنكية/ بطاقة ائتمان

3

Position Mada Logo Correctly

Follow the positioning requirements based on your checkout language:

Arabic Checkout Page:

• Mada logo should be the first from right

English Checkout Page:

• Mada logo should be the first from left

If you're using Custom Integration, you must implement additional BIN detection functionality:

1

Implement BIN Detection

Check the card BIN (first 6 digits) as soon as the customer starts entering their card number.

BIN Detection Example

function detectCardType(cardNumber) {
  const bin = cardNumber.substring(0, 6);
  
  // Check against Mada BIN ranges
  if (isMadaBIN(bin)) {
    displayMadaLogo();
    return 'mada';
  }
  
  return 'other';
}

2

Display Mada Logo Dynamically

When a Mada BIN is detected, display the Mada logo inside the payment form immediately.

3

Handle BIN Mismatches

If Mada is a standalone option and a non-Mada BIN is entered, alert customers to choose the correct payment method.

BIN Validation Example

function validateCardSelection(selectedMethod, detectedType) {
  if (selectedMethod === 'mada' && detectedType !== 'mada') {
    showAlert('Please select Credit Card for non-Mada cards');
    return false;
  }
  return true;
}

Branding Resources

Download the required files for Mada implementation:

Mada BIN List

Updated Mada BIN ranges for BIN detection implementation. Essential for Custom Integration to identify Mada cards.

📊 Download BIN List

Mada Toolkit

Complete branding toolkit containing Mada logos, guidelines, positioning rules, and all required assets for compliance.

📦 Download Toolkit

Do NOT change Mada branding after we sign off your integration. Any modifications require re-approval.