Moamalat

https://docs.moamalat.net/
Admin
Moamalat is an online payment platform that enables e-commerce websites, mobile applications, and...
Tokens:9,120
Snippets:142
Trust Score:6.1
Update:3 months ago
Show doc for...
Tokens:
Raw
### Add Maven Repository to Project (Full Example)

Source: https://docs.moamalat.net/androidSDK.html

An example of how to add the JitPack repository within the allprojects block of your project-level build.gradle file.

```gradle
allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}
```

--------------------------------

### Install/Update Pods

Source: https://docs.moamalat.net/iosSDK.html

Run these commands in your terminal from the project path to install or update the SDK pods.

```bash
//(for first try)
$ pod deintegrate
$ pod update
//(for second try)
$ pod install
```

--------------------------------

### Notification Request Example

Source: https://docs.moamalat.net/notification.html

This JSON payload represents a sample request message for initiating a transaction notification. Ensure all mandatory fields are correctly populated.

```json
{
                "MerchantId":"12345678901",
                "TerminalId":"12345678",
                "DateTimeLocalTrxn":"20191231083054",
                "SecureHash":"B19F0899B305363544E81D9DADD95DFDBD0605700CC1CB02A0C2746A90D62DE8",
                "TxnType":1,
                "Message":"Approved",
                "PaidThrough":"Card",
                "SystemReference":"534727",
                "NetworkReference":"2070043320",
                "MerchantReference":null,
                "Amount":"200000",
                "Currency":"818",
                "PayerAccount":"4000000XXXXXX38",
                "PayerName":null,
                "ActionCode":"00"
            }
```

--------------------------------

### Add SDK Dependency to App (Dependencies Block)

Source: https://docs.moamalat.net/androidSDK.html

Example of adding the NUMO Android SDK dependency within the dependencies block of your app-level build.gradle file.

```gradle
dependencies {
    implementation 'com.github.payskyCompany:NUMO-PayButton-SDK-
        android:1.0.7'
}
```

--------------------------------

### Close Lightbox

Source: https://docs.moamalat.net/lightBox.html

Use this function to programmatically close the Moamalat Gateway Lightbox, for example, after a specific user action or timeout.

```javascript
Lightbox.Checkout.closeLightbox();
```

--------------------------------

### Notification Response Example

Source: https://docs.moamalat.net/notification.html

This JSON payload represents a sample response message indicating the success or failure of a transaction notification initiation. The 'Success' field is a boolean value.

```json
{
        "Message":"Success”,
        "Success":true
    }
```

--------------------------------

### Initializing and Using the Payment Button

Source: https://docs.moamalat.net/iosSDK.html

This snippet demonstrates how to import the SDK, create an instance of the PaymentViewController, set the necessary payment parameters, and initiate the payment process.

```APIDOC
## Using SDK

In order to use our SDK you should get merchant id and Terminal id from Moamalat company.

First:
```swift
import PayButtonNumo
```

Second create a new instance from PayButtonNumo:
```swift
let paymentViewController = PaymentViewController()
```

You need to just pass some parameters to PayButton class instance:
> * Merchat id.
> * Terminal id.
> * Payment amount.
> * Currency code [Optional].
> * Merchant secure hash.
> * Transaction Reference Number.

* * *
> Note that: you should keep your secure hash and merchant id and terminal id with encryption before saving them in storage if you want.

### Example:-
```swift
paymentViewController.amount = "amount" // Formatted amount as smallest amount of currency ex: 1 LYD = \"1.000\"
paymentViewController.delegate = self // PaymentDelegate 
paymentViewController.mId = "XXXXX" // your merchant id 
paymentViewController.tId = "XXXXXX” // your terminal id 
paymentViewController.Currency = "***" // use 434 for the Libyan currency
paymentViewController.refnumber = "reference number""  // unique transaction reference number.
paymentViewController.Key = "********” // Merchant secure hash
paymentViewController.AppStatus =  NumoUrlTypes.Numo_Testing
paymentViewController.pushViewController()
```
```

--------------------------------

### Initialize and Configure PaymentViewController

Source: https://docs.moamalat.net/iosSDK.html

Create an instance of PaymentViewController and set its properties with your merchant details, amount, currency, and transaction reference. Set the delegate and app status for testing.

```swift
let paymentViewController = PaymentViewController ()

paymentViewController.amount = "amount" // Formatted amount as smallest amount of currency ex: 1 LYD = “1.000”
paymentViewController.delegate = self // PaymentDelegate 
paymentViewController.mId = "XXXXX" // your merchant id 
paymentViewController.tId = "XXXXXX” // your terminal id 
paymentViewController.Currency = "***" // use 434 for the Libyan currency
paymentViewController.refnumber = "reference number"  // unique transaction reference number.
paymentViewController.Key = "********” // Merchant secure hash
paymentViewController.AppStatus =  NumoUrlTypes.Numo_Testing
paymentViewController.pushViewController()
```

--------------------------------

### Configure Lightbox Checkout

Source: https://docs.moamalat.net/lightBox.html

Set up the Lightbox.Checkout.configure object with essential transaction details and callback functions. This configuration is required before showing the lightbox.

```javascript
Lightbox.Checkout.configure = {
  MID: mID,
  TID: tID,
  AmountTrxn: amount,
  MerchantReference: "merchantReference",
  TrxDateTime: "202009171418",
  SecureHash:
    "EAD7AB68E23BFF2E5B03F4A0CD41581722FD14C349C6743CD91B577341465A61",
  completeCallback: function (data) {
    //your code here
  },
  errorCallback: function (error) {
    //your code here
  },
  cancelCallback: function () {
    //your code here
  },
};
```

--------------------------------

### Initialize PayButton Instance

Source: https://docs.moamalat.net/androidSDK.html

Create a new instance of the PayButton class. Ensure Merchant ID, Terminal ID, and other sensitive details are encrypted before storage.

```java
PayButton payButton = new PayButton(context);
```

--------------------------------

### Show Lightbox

Source: https://docs.moamalat.net/lightBox.html

Call this function to initiate the payment process and display the Moamalat Gateway Lightbox to the user after configuration.

```javascript
Lightbox.Checkout.showLightbox();
```

--------------------------------

### Add Maven Repository to Project

Source: https://docs.moamalat.net/androidSDK.html

Configure your project-level build.gradle file to include the JitPack repository. This is necessary to download the SDK.

```gradle
maven { url 'https://jitpack.io' }
```

--------------------------------

### Add PayButtonNumo to Podfile

Source: https://docs.moamalat.net/iosSDK.html

Add this line to your project's Podfile to include the Numo payment SDK.

```ruby
pod 'PayButtonNumo'
```

--------------------------------

### Import PayButtonNumo SDK

Source: https://docs.moamalat.net/iosSDK.html

Import the PayButtonNumo SDK into your Swift file before using its functionalities.

```swift
import PayButtonNumo
```

--------------------------------

### Reference Lightbox.js File

Source: https://docs.moamalat.net/lightBox.html

Include this script tag in your HTML to load the Moamalat Gateway Lightbox functionality. Ensure you use the correct URL for your environment (Test or Production).

```html
<script src="https://tnpg.moamalat.net:6006/js/lightbox.js"> </script>
```

--------------------------------

### PayButton Initialization

Source: https://docs.moamalat.net/androidSDK.html

Initialize the PayButton with necessary merchant and transaction details. Ensure sensitive information like Merchant ID, Terminal ID, and secure hash are encrypted.

```APIDOC
## PayButton Initialization

### Description
Initialize the PayButton with merchant ID, terminal ID, payment amount, currency code, merchant secure hash, and transaction reference number. Sensitive details should be encrypted before storage.

### Parameters
- **context**: Android context.
- **merchantId**: String - Your merchant ID.
- **terminalId**: String - Your terminal ID.
- **amount**: Double - The payment amount.
- **currencyCode**: Integer - Optional. Use 434 for Libyan currency.
- **merchantSecureHash**: String - Your merchant secure hash.
- **transactionReferenceNumber**: String - A unique transaction reference number. Can be generated using `AppUtils.generateRandomNumber()`.
- **productionStatus**: Enum (STAGINIG or PRODUCTION) - Use `AllURLsStatus.STAGINIG` for test environment, `AllURLsStatus.PRODUCTION` for production.
- **lang**: String - Language code.

### Example
```java
PayButton payButton = new PayButton(context);
payButton.setMerchantId("XXXXXXXX");
payButton.setTerminalId("XXXXXXXXXXX");
payButton.setAmount(0);
payButton.setCurrencyCode(434);
payButton.setMerchantSecureHash("");
payButton.setTransactionReferenceNumber(AppUtils.generateRandomNumber());
payButton.setProductionStatus(STAGINIG);
payButton.setLang("localLang");
```
```

--------------------------------

### Configure PayButton Parameters

Source: https://docs.moamalat.net/androidSDK.html

Set essential parameters for the PayButton, including merchant and terminal IDs, payment amount, currency, secure hash, transaction reference, production status, and language.

```java
payButton.setMerchantId("XXXXXXXX");
        // your merchant id 
    payButton.setTerminalId("XXXXXXXXXXX"); 
        // your terminal id 
    payButton.setAmount(0);
        // the payment amount 
    payButton.setCurrencyCode(434);
        // use 434 for the Libyan currency [Optional]
    payButton.setMerchantSecureHash("");
        // Merchant secure hash 
    payButton.setTransactionReferenceNumber("");
        // unique transaction reference number.
    payButton.setProductionStatus(STAGINIG);
        // "Use AllURLsStatus.STAGINIG for test environment, 
        //AllURLsStatus.PRODUCTION for production"
    payButton.setLang("localLang");
```

--------------------------------

### Create Transaction

Source: https://docs.moamalat.net/androidSDK.html

Initiate a payment transaction using the PayButton. This method handles both card and wallet transactions and provides callbacks for success and error scenarios.

```APIDOC
## Create Transaction

### Description
Creates a payment transaction. This method accepts a callback listener that handles success for card transactions, success for wallet transactions, and errors.

### Method
`createTransaction(PayButton.PaymentTransactionCallback callback)`

### Parameters
- **callback**: `PayButton.PaymentTransactionCallback` - An interface with methods to handle transaction outcomes.
  - **onCardTransactionSuccess(SuccessfulCardTransaction cardTransaction)**: Called when a card transaction is successful. `SuccessfulCardTransaction` contains `NetworkReference`, `AuthCode`, `ActionCode`, `ReceiptNumber`, and `Amount`.
  - **onWalletTransactionSuccess(SuccessfulWalletTransaction walletTransaction)**: Called when a wallet transaction is successful. `SuccessfulWalletTransaction` contains `NetworkReference` and `Amount`.
  - **onError(TransactionException error)**: Called when the transaction fails, providing a `TransactionException` object with error details.

### Request Example
```java
payButton.createTransaction(new PayButton.PaymentTransactionCallback() {
    @Override
    public void onCardTransactionSuccess(SuccessfulCardTransaction cardTransaction) {
        // Handle successful card transaction
        Toast.makeText(MainActivity.this, cardTransaction.toString(), Toast.LENGTH_LONG).show();
    }

    @Override
    public void onWalletTransactionSuccess(SuccessfulWalletTransaction walletTransaction) {
        // Handle successful wallet transaction
        Toast.makeText(MainActivity.this, walletTransaction.toString(), Toast.LENGTH_LONG).show();
    }

    @Override
    public void onError(TransactionException error) {
        // Handle transaction error
        Toast.makeText(MainActivity.this, error.toString(), Toast.LENGTH_LONG).show();
    }
});
```
```

--------------------------------

### Create Payment Transaction

Source: https://docs.moamalat.net/androidSDK.html

Initiate a payment transaction using the createTransaction method. Implement the PaymentTransactionCallback to handle success for card or wallet transactions, or errors.

```java
payButton.createTransaction(new
    PayButton.PaymentTransactionCallback() {
        @Override
        public void onCardTransactionSuccess
            (SuccessfulCardTransaction cardTransaction) {
                Toast.makeText(MainActivity.this,
                                cardTransaction.toString(),
                                Toast. LENGTH_LONG)
                                .show();
            }
        @Override
        public void onWalletTransactionSuccess
            (SuccessfulWalletTransaction walletTransaction) {
                Toast.makeText(MainActivity.this,
                            walletTransaction.toString(),
                            Toast.LENGTH_LONG)
                            .show();
            }
        @Override
        public void onError(TransactionException error) {
            Toast.makeText(MainActivity.this,
                            error.toString(),
                            Toast.LENGTH_LON G)
                            .show();
            });
```

--------------------------------

### Generate Random Transaction Reference

Source: https://docs.moamalat.net/androidSDK.html

Use AppUtils.generateRandomNumber() to create a unique transaction reference number for each transaction.

```java
payButton.setTransactionReferenceNumber(AppUtils.generateRandomNumber());
```

--------------------------------

### Moamalat Gateway Transaction Request Parameters

Source: https://docs.moamalat.net/lightBox.html

These are the parameters required to initiate a transaction with the Moamalat Gateway.

```APIDOC
## REQUEST PARAMETERS 

| Item | Data Type | Length | Optional/Mandatory | Comments |
|---|---|---|---|---|
| MID | String | 11-18 | M | The configured Moamalat Gateway Merchant ID |
| TID | String | 6-8 | M | Moamalat Gateway configured Terminal ID for the merchant |
| AmountTrxn | Integer | 1-15 | M | The payment amount in smallest currency unit, i.e., 1 Libyan dinar should be 1000 |
| MerchantReference | String | 1-50 | O | Merchant reference for the transaction. |
| TrxDateTime | String | 12 | O | Request datetime in format “yyyyMMddHHmm” and it will be required when sending secure hash at request. |
| SecureHash | String | 64 | M | Used for request integrity between client call and server. |
```

--------------------------------

### Add SDK Dependency to App

Source: https://docs.moamalat.net/androidSDK.html

Include the NUMO Android SDK as an implementation dependency in your app-level build.gradle file. Ensure you use the latest version available.

```gradle
implementation 'com.github.payskyCompany:NUMO-PayButton-SDK-
    android:1.0.7'
```

--------------------------------

### Moamalat Gateway Successful Callback Parameters

Source: https://docs.moamalat.net/lightBox.html

Parameters received in a successful callback from the Moamalat Gateway after a transaction.

```APIDOC
## COMPLETE CALLBACK PARAMETERS 

| Item | Data Type | Length | Optional/Mandatory | Comments |
|---|---|---|---|---|
| TxnDate | String | 12 | M | Transaction execution date and time, format yyyyMMddHHmm. |
| SystemReference | String | 2-20 | M | Moamalat Gateway transaction reference. |
| NetworkReference | String | 10-15 | M | Gateway reference number in case of card transactions. |
| MerchantReference | String | 1-50 | O | Merchant reference for the transaction. |
| Amount | String | 1-15 | M | The payment amount in smallest currency unit, i.e., 1 Libyan dinar should be 1000. |
| Currency | String | 3 | M | Transaction currency ISO code, LYD represented by 434. |
| PaidThrough | String | 4-10 | M | Transaction payment method (Card, Tahweel, mVisa). |
| PayerAccount | String | 14-36 | M | Masked card number in case of (card) transaction or (mobile number) in case of Wallet transaction. |
| PayerName | String | 0-50 | O | Payer name associated to the payer account. |
| ProviderSchemeName | String | 5-20 | O | Payer wallet provider name. |
| SecureHash | String | 64 | M | Used for response callback integrity between client call and server. |

```json
{
    "Amount": "100",
    "Currency": "818",
    "MerchantReference": "Txn-1234",
    "NetworkReference": "10005908321",
    "PaidThrough": "Card",
    "PayerAccount": "400000XXXXXX0002",
    "PayerName": "123",
    "ProviderSchemeName": "",
    "SecureHash": "7E78BC68D15B717317ED7BBDC99A4AF7C50491D0D1E99155FD103B851428D2CD",
    "SystemReference": "78554",
    "TxnDate": "200917135922"
}
```
```

--------------------------------

### Moamalat Gateway Complete Callback Parameters

Source: https://docs.moamalat.net/lightBox.html

This JSON object represents the parameters received in a successful transaction callback from the Moamalat Gateway. It includes transaction details, references, and security hash.

```json
{
    "Amount": "100",
    "Currency": "818",
    "MerchantReference": "Txn-1234",
    "NetworkReference": "10005908321",
    "PaidThrough": "Card",
    "PayerAccount": "400000XXXXXX0002",
    "PayerName": "123",
    "ProviderSchemeName": "",
    "SecureHash": "7E78BC68D15B717317ED7BBDC99A4AF7C50491D0D1E99155FD103B851428D2CD",
    "SystemReference": "78554",
    "TxnDate": "200917135922"
}
```

--------------------------------

### Moamalat Gateway Error Callback Parameters

Source: https://docs.moamalat.net/lightBox.html

Parameters received in an error callback from the Moamalat Gateway.

```APIDOC
## ERROR CALLBACK PARAMETERS 

| Item | Data Type | Length | Optional/Mandatory | Comments |
|---|---|---|---|---|
| error | String | 11-18 | M | Error message and may contain error codes. |
| DateTimeLocalTrxn | String | 12 | M | Error datetime |
| MerchantReference | Integer | 1-50 | O | Merchant reference for the transaction |
| Amount | String | 12 | O | transaction amount |
| SecureHash | String | 64 | M | Used for request integrity between client call and server. |

```json
{
     "Amount": "1",
     "DateTimeLocalTrxn": "200917142042",
     "MerchantReferenece": "Txn-1234",
     "SecureHash": "6226DEDA2D88E356BF3552F089EBC228242AC5B2ACD72C7A8B9749E048C65C0C",
     "error": "Host Error"
}
```
```

--------------------------------

### Moamalat Gateway Error Callback Parameters

Source: https://docs.moamalat.net/lightBox.html

This JSON object details the parameters returned in an error callback from the Moamalat Gateway. It includes error information, transaction details, and a security hash.

```json
{
     "Amount": "1",
     "DateTimeLocalTrxn": "200917142042",
     "MerchantReferenece": "Txn-1234",
     "SecureHash": "6226DEDA2D88E356BF3552F089EBC228242AC5B2ACD72C7A8B9749E048C65C0C",
     "error": "Host Error"
}
```

--------------------------------

### Notification Services Request and Response

Source: https://docs.moamalat.net/notification.html

This section details the expected request and response message formats for the Notification Services API. Merchants need to implement a restful service according to these specifications to receive transaction notifications.

```APIDOC
## Request Message Format

### Description
This is the format for the request message that merchants need to implement to receive transaction notifications.

### Fields
Item| Data Type| Leanght| Optional/ Mandatory| Comments  
---|---|---|---|---
MerchantId| String| 11-18| M| The Merchant ID  
TerminalId| String| 1-8| M| The terminal ID defined to use APIs  
SecureHash| String| 20-250| M| A keyed hash message authorization code (HMAC) is a specific type of message authorization code (MAC) involving a cryptographic hash function and a secret cryptographic key. It is used to verify both the data integrity and the authorization of a message.  
DateTimeLocalTrxn| String| 12-12| M| The transaction execution date and time with format” yyyyMMddHHmmss”.  
TrxDateTime| String| 12| O| Request datetime in format “yyyyMMddHHmm” and it will be required when sending secure hash at request.  
Message| String| 0-250| M| The message describes the transaction initiation status.  
TxnType| Integer| 1-5| M| Identifies transaction type: (1- Sale, 2- Refund, 3- Void Sale, 4- Void Refund)  
PaidThrough| String| 1-50| M| The source of transaction execution (Card, Wallet, etc…).  
SystemReference| String| 1-14| M| Moamalat gateway Reference number.  
NetwrokReference| String| 0-32| O| Network reference number.  
MerchantReference| String| 0-300| O| Merchant Reference for this transaction, TLV.  
Amount| String| 1-15| M| The original transaction amount in smallest currency units.  
Currency| String| 3-3| M| The Transaction Currency shall conform to [ISO 4217] and shall contain the 3-digit numeric representation of the currency. For example, EGP is represented by the value "818".  
PayerAccount| String| 10-100| M| The customer account used for the transaction, for card transactions it’s the masked card number.  
ActionCode| String| 0-3| O| The payment gateway action code.  
SID| String| 0-200| O| Terminal SID.  
Token| String| 0-200| O| Terminal Token  

### Request Example
```json
{
    "MerchantId":"12345678901",
    "TerminalId":"12345678",
    "DateTimeLocalTrxn":"20191231083054",
    "SecureHash":"B19F0899B305363544E81D9DADD95DFDBD0605700CC1CB02A0C2746A90D62DE8",
    "TxnType":1,
    "Message":"Approved",
    "PaidThrough":"Card",
    "SystemReference":"534727",
    "NetworkReference":"2070043320",
    "MerchantReference":null,
    "Amount":"200000",
    "Currency":"818",
    "PayerAccount":"4000000XXXXXX38",
    "PayerName":null,
    "ActionCode":"00"
}
```

## Response Message Format

### Description
This is the format for the response message received from the Notification Services.

### Fields
Item| Data Type| Leanght| Optional/ Mandatory| Comments  
---|---|---|---|---
Message| String| 0-250| M| The message describes the transaction initiation status.  
Success| Boolean| 4-4| M| True, if the transaction initiated successfully.  

### Response Example
```json
{
    "Message":"Success",
    "Success":true
}
```
```

--------------------------------

### Moamalat Gateway Transaction Filter Request

Source: https://docs.moamalat.net/filter-api.html

This JSON object represents a request to filter transactions from the Moamalat Gateway. Ensure all mandatory fields are included and formatted correctly.

```json
{
    "MerchantReference":"MR123EF278",
    "TerminalId":"84949616",
    "MerchantId":"45374",
    "DisplayLength":"1",
    "DisplayStart":"0",
    "DateTimeLocalTrxn":"181142172106",
    "SecureHash":"F69E47CE228EA038034B71647DF069
    01BA36CD19F639D5CAE4AB4CA5D2D93014"
}
```

--------------------------------

### Moamalat Gateway Transaction Filter Response

Source: https://docs.moamalat.net/filter-api.html

This JSON object illustrates a successful response from the Moamalat Gateway's transaction filter API. It contains transaction details and status information.

```json
{
    "Message": null,
    "Success": true, "TotalCountAllTransaction": 1,
    "Transactions": [
    {
    "Date": "18/11/2018",
    "DateTotalAmount": "154",
    "DateTransactions": [
        {
        "Amnt": "77",
        "AmountTrxn": "77",
        "CardNo": "400000XXXXXX0002",
        "CardType": "VISA",
        "Currency": "EGP",
        "ExternalTxnId": null,
        "FeeAmnt": "0",
        "IsRefundEnabled": true,
        "IsSend": false,
        "MerchantReference": "Merchant_REF",
        "MobileNumber": null,
        "RRN": "1100053340",
        "ReceiptNo": "832302529385",
        "ResCodeDesc": "Approved",
        "STAN": "878561",
        "SenderName": null,
        "Status": "Approved",
        "TipAmnt": "0",
        "TransType": "Sale",
        "TransactionChannel": "Card",
        "TransactionId": "65324",
        "TxnDateTime": "18/11/18 17:15"
        }
    ]
    }
    ]
}
```

--------------------------------

### FilterTransactions

Source: https://docs.moamalat.net/filter-api.html

Allows merchants to search transaction logs based on provided criteria. It supports filtering by merchant reference, network reference, terminal ID, merchant ID, date range, and sorting options.

```APIDOC
## POST /api/FilterTransactions

### Description
Retrieves transaction data based on specified search criteria. This endpoint is used to query the transaction log for a merchant.

### Method
POST

### Endpoint
Test: https://tnpg.moamalat.net/cube/paylink.svc/api/FilterTransactions
Production: https://npg.moamalat.net/cube/paylink.svc/api/FilterTransactions

### Parameters
#### Request Body
- **MerchantReference** (String) - Optional - Merchant Reference for the transaction.
- **NetworkReference** (String) - Optional - Payment gateway reference number in case of card transactions.
- **TerminalId** (String) - Mandatory - The Moamalat terminal ID.
- **MerchantId** (String) - Mandatory - Moamalat Merchant Id applied the transaction.
- **DisplayLength** (String) - Mandatory - Number of Transactions required to be returned for the request.
- **DisplayStart** (String) - Mandatory - The index to start fetch data from.
- **DateTimeLocalTrxn** (String) - Mandatory - The request execution date and time with format “YYMMDDHHMMSS” and it should be unique per terminal requests.
- **DateFrom** (String) - Optional - The transaction execution date and time with format “yyyyMMdd” to start search from.
- **DateTo** (String) - Optional - The transaction execution date and time with format “yyyyMMdd” to end search to.
- **SortCol** (String) - Optional - The column name you want to sort data with.
- **SortDir** (String) - Optional - The Sort direction either “asc” or “desc”.
- **SecureHash** (String) - Mandatory - A keyed hash message authorization code (HMAC).

### Request Example
```json
{
    "MerchantReference":"MR123EF278",
    "TerminalId":"84949616",
    "MerchantId":"45374",
    "DisplayLength":"1",
    "DisplayStart":"0",
    "DateTimeLocalTrxn":"181142172106",
    "SecureHash":"F69E47CE228EA038034B71647DF06901BA36CD19F639D5CAE4AB4CA5D2D93014"
}
```

### Response
#### Success Response (200)
- **Message** (String) - The message describes the transaction execution status.
- **Success** (Boolean) - Describes transaction execution status.
- **Transactions** (Array) - The array of transactions returned from applying search parameters.
  - **CardNo** (String) - The card number executed the transaction.
  - **DisplayLength** (String) - Number of Transactions required to be returned for the request.
  - **DisplayStart** (String) - The index to start fetch data from.
  - **Amnt** (String) - The transaction amount in smallest currency unit.
  - **Status** (String) - "Approved" if the transaction executed successfully.
  - **Currency** (String) - The Transaction Currency shall conform to [ISO 4217] and shall contain the 3-digit numeric representation of the currency.
  - **TransType** (String) - The transaction type.
  - **CardType** (String) - The card type.
  - **STAN** (String) - The system trace number.
  - **RRN** (String) - Retrieval reference number returned by the payment gateway.
  - **MerchantReference** (String) - Merchant Reference for this transaction.
  - **CardReceiptNoType** (String) - The receipt number returned by the payment gateway.
- **TotalCountAllTransaction** (Integer) - The total count of returned transactions from search result.

#### Response Example
```json
{
    "Message": null,
    "Success": true, 
    "TotalCountAllTransaction": 1,
    "Transactions": [
    {
        "Date": "18/11/2018",
        "DateTotalAmount": "154",
        "DateTransactions": [
            {
                "Amnt": "77",
                "AmountTrxn": "77",
                "CardNo": "400000XXXXXX0002",
                "CardType": "VISA",
                "Currency": "EGP",
                "ExternalTxnId": null,
                "FeeAmnt": "0",
                "IsRefundEnabled": true,
                "IsSend": false,
                "MerchantReference": "Merchant_REF",
                "MobileNumber": null,
                "RRN": "1100053340",
                "ReceiptNo": "832302529385",
                "ResCodeDesc": "Approved",
                "STAN": "878561",
                "SenderName": null,
                "Status": "Approved",
                "TipAmnt": "0",
                "TransType": "Sale",
                "TransactionChannel": "Card",
                "TransactionId": "65324",
                "TxnDateTime": "18/11/18 17:15"
            }
        ]
    }
    ]
}
```
```
Tokens:
Raw