Trusted Channel Request\Response

Request Parameters

command^{(String, mandatory)}

Maximum Length	Possible/ expected values	Description
20	AUTHORIZATION, PURCHASE	A command for payFORT server to understand.

access_code^{(alphanumeric, mandatory)}

Maximum Length	Example	Description
20	zx0IPmPy5jp1vAz8Kpg7	Merchant access code that can be found in the backoffice

merchant_identifier^{(alphanumeric, mandatory)}

Maximum Length	Example	Description
20	CycHZxVj	Merchant ID that can be found in the backoffice

merchant_reference^{(alphanumeric, mandatory)}

Maximum Length	Example	Special Characters	Description
40	XYZ9239-yu898	- _ .	The Merchant’s unique order number.

amount^{(numeric, mandatory)}

Maximum Length	Example	Description
10	10000	The transaction’s amount. *Each currency has predefined allowed decimal points that should be taken into consideration when sending the amount check the note after this table.

currency^{(String, mandatory)}

Maximum Length	Example	Description
3	AED	The currency of the transaction’s amount in ISO code 3.

language^{(String, mandatory)}

Maximum Length	Possible/ expected values	Description
2	en/ar	The checkout page and messages language where en is for english and ar for Arabic

customer_email^{(alphanumeric, mandatory)}

Maximum Length	Example	Special characters	Description
254	customer1@domain.com	_ - . @ +	The customer’s email.

expiry_date^{(numeric, mandatory)}

Maximum Length	Example	Description
4	2105	The card’s expiry date.

card_number^{(numeric, mandatory)}

Maximum Length	Example	Description
19	4005550000000001	The clear credit card’s number. Only the MEEZA payment option takes 19 digits card number. AMEX payment option takes 15 digits card number. *Otherwise, they take 16 digits card number.

card_security_code^{(numeric, mandatory)}

Maximum Length	Example	Description
4	123	The clear card security code collect on the merchant’s checkout page. It’s ONLY mandatory in the ecommerce requests. Only AMEX accepts card security code of 4 digits.

card_holder_name^{(String, mandatory)}

Maximum Length	Example	Special Characters	Description
50	John Smith	`'`- .	The card holder name.

signature^{(alphanumeric, mandatory)}

Maximum Length	Example	Description
200	7cad05f0212ed933c9a5d5dffa31661acf2c827a	A string hashed using the Secure Hash Algorithm. Please refer to section Signature

token_name^{(alphanumeric, optional)}

Maximum Length	Example	Special characters	Description
100	Op9Vmp	. @ - _	The Token received from the Tokenization process.

payment_option^{(String, optional)}

Maximum Length	Possible/ expected values	Description
10	- MASTERCARD - VISA - AMEX - MADA (for Purchase operations and eci Ecommerce only) Click here to download MADA Branding Document - MEEZA (for Purchase operations and ECOMMERCE eci only)	Payment option.

eci^{(String, optional)}

Maximum Length	Possible/ expected values	Description
16	-ECOMMERCE - MOTO	E-commerce indicator. *MOTO and E-commerce indicator clickable in VISA, MASTERCARD and AMEX.

order_description^{(Alphanumeric, optional)}

Maximum Length	Example		Description
150	iPhone 6-S	`'`/ . _ - # : $ Space	It holds the description of the order.

customer_ip^{(Alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
45	IPv4 → 192.178.1.10 IPv6 → 2001:0db8:3042:0002:5a55:caff:fef6:bdbf	. :	It holds the customer’s IP address. *We support IPv4 and IPv6 as shown in the example.

customer_name^{(String, optional)}

Maximum Length	Example	Special Characters	Description
40	John Smith	_ \ / - . `'`Space	The customer’s name.

merchant_extra^{(alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
999	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra1^{(alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra2^{(alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra3^{(alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra4^{(alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra5^{(alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra5^{(alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

remember_me^{(alpha, optional)}

Maximum Length	Possible/ expected values	Description
2	-YES -No	This parameter provides you with an indication to whether to save this token for the user based on the user selection.

phone_number^{(numeric, optional)}

Maximum Length	Example	Special Characters	Description
19	00962797219966	+ - ( ) Space	The customer’s phone number.

settlement_reference^{(alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
34	00962797219966	- _ .	The Merchant submits this value to the FORT. The value is then passed to the Acquiring bank and displayed to the merchant in the Acquirer settlement file.

return_url^{(alphanumeric, optional)}

Maximum Length	Example	Special Characters	Description
400	http://www.merchant.com	$ ! = ? # & - _ / : .	The URL of the Merchant’s page that will be displayed to the customer when the order is processed.

Before sending the amount value of any transaction, you have to multiply the value with the currency decimal code according to ISO code 3. For example: If the amount value was 500 AED; according to ISO code 3, you should multiply the value with 100 (2 decimal points); so it will be sent in the request as 50000. Another example: If the amount value was 100 JOD; according to ISO code 3, you should multiply the value with 1000 (3 decimal points); so it will be sent in the request as 100000.

Trusted Channel - Response

command^(String)

Maximum Length	Possible/ expected values	Description
20	AUTHORIZATION, PURCHASE	A command for payFORT server to understand.

access_code^{(alphanumeric)}

Maximum Length	Example	Description
20	zx0IPmPy5jp1vAz8Kpg7	Merchant access code that can be found in the backoffice

merchant_identifier^{(alphanumeric)}

Maximum Length	Example	Description
20	CycHZxVj	Merchant ID that can be found in the backoffice

merchant_reference^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
40	XYZ9239-yu898	- _ .	The Merchant’s unique order number.

amount^(numeric)

Maximum Length	Example	Description
10	10000	The transaction’s amount. *Each currency has predefined allowed decimal points that should be taken into consideration when sending the amount check the note after this table.

currency^(String)

Maximum Length	Example	Description
3	AED	The currency of the transaction’s amount in ISO code 3.

language^(String)

Maximum Length	Possible/ expected values	Description
2	en/ar	The checkout page and messages language where en is for english and ar for Arabic

customer_email^{(alphanumeric)}

Maximum Length	Example	Special characters	Description
254	customer1@domain.com	_ - . @ +	The customer’s email.

expiry_date^(numeric)

Maximum Length	Example	Description
4	2105	The card’s expiry date.

card_number^(numeric)

Maximum Length	Example	Description
19	4005550000000001	The clear credit card’s number. Only the MEEZA payment option takes 19 digits card number. AMEX payment option takes 15 digits card number. *Otherwise, they take 16 digits card number.

card_security_code^(numeric)

Maximum Length	Example	Description
4	123	The clear card security code collect on the merchant’s checkout page. It’s ONLY mandatory in the ecommerce requests. Only AMEX accepts card security code of 4 digits.

card_holder_name^(String)

Maximum Length	Example	Special Characters	Description
50	John Smith	`'`- .	The card holder name.

signature^{(alphanumeric)}

Maximum Length	Example	Description
200	7cad05f0212ed933c9a5d5dffa31661acf2c827a	A string hashed using the Secure Hash Algorithm. Please refer to section Signature

token_name^{(alphanumeric)}

Maximum Length	Example	Special characters	Description
100	Op9Vmp	. @ - _	The Token received from the Tokenization process.

payment_option^(String)

Maximum Length	Possible/ expected values	Description
10	- MASTERCARD - VISA - AMEX - MADA (for Purchase operations and eci Ecommerce only) Click here to download MADA Branding Document - MEEZA (for Purchase operations and ECOMMERCE eci only)	Payment option.

eci^(String)

Maximum Length	Possible/ expected values	Description
16	-ECOMMERCE - MOTO	E-commerce indicator. *MOTO and E-commerce indicator clickable in VISA, MASTERCARD and AMEX.

order_description^{(Alphanumeric)}

Maximum Length	Example		Description
150	iPhone 6-S	`'`/ . _ - # : $ Space	It holds the description of the order.

customer_ip^{(Alphanumeric)}

Maximum Length	Example	Special Characters	Description
45	IPv4 → 192.178.1.10 IPv6 → 2001:0db8:3042:0002:5a55:caff:fef6:bdbf	. :	It holds the customer’s IP address. *We support IPv4 and IPv6 as shown in the example.

customer_name^(String)

Maximum Length	Example	Special Characters	Description
40	John Smith	_ \ / - . `'`Space	The customer’s name.

merchant_extra^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
999	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra1^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra2^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra3^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra4^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra5^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

merchant_extra5^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
250	John Smith	. ; / _ - , `'`@	Extra data sent by merchant. Will be received and sent back as received. Will not be displayed in any report.

remember_me^(alpha)

Maximum Length	Possible/ expected values	Description
2	-YES -No	This parameter provides you with an indication to whether to save this token for the user based on the user selection.

phone_number^(numeric)

Maximum Length	Example	Special Characters	Description
19	00962797219966	+ - ( ) Space	The customer’s phone number.

settlement_reference^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
34	00962797219966	- _ .	The Merchant submits this value to the FORT. The value is then passed to the Acquiring bank and displayed to the merchant in the Acquirer settlement file.

return_url^{(alphanumeric)}

Maximum Length	Example	Special Characters	Description
400	http://www.merchant.com	$ ! = ? # & - _ / : .	The URL of the Merchant’s page that will be displayed to the customer when the order is processed.

Every parameter the Merchant sends in the Request should be received by the Merchant in the Response -even the optional ones.