Pre-requisites

2.1 Merchant Pre-requisites

This section outlines the hardware, software, and general requirements necessary for successful SDK integration.

2.2 Hardware Pre-requisites

The following hardware specifications are recommended for Android SDK development and integration:

Network and Connectivity Requirements:

  1. Merchants may have a variety of arrangements for hosting their applications and systems, with relevant security mandates for internet access controls and checks.
  2. This may include utilization of a Proxy Server which presents informed challenges.
  3. It is recommended that the merchant use a public IP address during the integration testing for transaction processing to the Payment Gateway.
  4. The merchant should ensure the Payment Gateway domain and IP address are enabled at the firewall for both incoming and outgoing request/response traffic.

Development Machine Specifications:

RequirementSpecifications
ProcessorIntel i3 (8th generation or newer) / AMD Ryzen 3
RAM8 GB minimum (recommended for Android Studio and Gradle build)
Storage256 GB SSD (HDD will be very slow)
GraphicsIntegrated graphics (separate GPU not required; emulators may lag with integrated graphics)
Operating SystemWindows 10 (64-bit) / macOS (latest 3 versions) / Linux (Ubuntu preferred)

2.3 Software Pre-requisites

The merchant may use combinations of OS, development tools, and application servers while setting up and operating the application. Standard software options are listed below for reference.

Required Software Installation:

  1. Java Development Kit (JDK)

    • Install JDK 11 or JDK 17 (Android Studio works best with these versions)
  2. Android Studio

    • Official Integrated Development Environment (IDE) for Android development
    • Includes Gradle build system, Android Emulator, and SDK Manager
  3. Android SDK and Platform Tools

    • Installed via Android Studio SDK Manager
    • Includes tools such as Android Debug Bridge (adb)
    • Minimum API level: Android 5.0 (API 21)
    • Target API level: Latest stable Android version

2.4 General Pre-requisites

The following general requirements must be fulfilled before integration:

S. NoPre-requisite
1Merchant must be onboarded with Emirates NBD (Pinelabs) Merchant Management system
2Merchant must be onboarded at the Payment Gateway
3Merchant should have the integration kit from Emirates NBD (Pinelabs) Integration Team
4Payment Gateway integration parameters must be received/available from Emirates NBD integration kit:
  • Tranportal ID
  • Tranportal Password
  • Resource/Encryption Key
5Merchant should enable connectivity between their UAT environment and Bank Payment Gateway servers
6Emirates NBD must enable the SDK Payment instrument for the specific merchant/terminal