mada Conditional Lookup Fields

These fields are required for mada, which is only available in the Kingdom of Saudi Arabia (KSA) and for EMV 3DS 2.2.0. mada does not support any Protocol Versions lower than EMV 3DS 2.2.0.

Data Element/Field Name

Description

Condition

Field Definition

Data Element/Field Name

Description

Condition

Field Definition

Account Type Field Name: OverridePaymentMethod

Indicates the type of account.

Possible Values:

  • 03 = Debit

Note: This field shall be present and must be set to a default value of ‘03’ in the current implementation of the mada scheme. mada does not support credit transactions at this time.

Required on all mada transactions.

N(3)

Browser IP Address Field Name: IPAddress

IP address of the browser as returned by the HTTP headers to the 3DS Requestor.

Note:   IPv4 and IPv6 are supported.

Example:

IPv4 address:  <IPAddress>1.12.123.255</IPAddress>

IPv6 address: <IPAddress>2011:0db8:85a3:0101:0101:8a2e:03 70:7334</IPAddress>

Required for all mada browser based transactions

AN(45)

Card/Token Expiry Date Field Name: CardExpMonth Field Name: CardExpYear

Must send both fields.

Expiry Date of the PAN or token supplied to the 3DS Requestor by the Cardholder.

Format accepted: YYMM

Required on all mada transactions.

N(4)

Merchant Country Code Field Name: CountryCodeOverride

ISO 3166-1 numeric three-digit country code of the Merchant.
This value correlates to the Merchant Country Code as defined by each Payment System or DS. Configured on the Merchant account.

 

Required on all mada transactions

N(3)

Transaction Type Field Name: ProductCode

Identifies the type of transaction being authenticated.

Possible Values:

  • 01 = Goods/ Service Purchase

Note: This field shall be present and must be set to a default value of ‘01’ for the current implementation.

Required on all mada transactions

N(2)