Skip to main content
Version: v1.4.x Legacy

Overview

The Mobile Payment SDK (For iOS & Android)​

Is a solution for integrating secure card payment processing functionalities directly into mobile applications. Developed, specifically for iOS and Android platforms, the PCI-compliant SDK libraries provide developers with the tools to streamline payment workflows and enhance user experiences on both major, mobile platforms.

The SDK libraries are engineered with robust encryption protocols and stringent compliance standards to ensure that every transaction is conducted securely, protecting sensitive payment information about potential threats.

Key Features​

  1. iOS and Android Compatibility: With the separate SDK libraries tailored for iOS and Android platforms, developers can seamlessly integrate payment functionalities into applications while adhering to platform-specific guidelines and best practices.

  2. Card Payment Processing: The SDK libraries offer intuitive APIs that simplify the process of accepting card payments within iOS and Android applications, developers can effortlessly integrate payment processing capabilities to meet their specific business needs.

  3. PCI Compliance: The SDK libraries are PCI compliant, adhering to the strict security standards set forth by the Payment Card Industry Data Security Standard (PCI DSS). This compliance ensures that application meets the necessary requirements for securely processing and storing payment card data, providing peace of mind to both merchants and customers.

Important Note!​

Important

When creating a payment request for mobile SDK integration, you must include the appChannel boolean flag and set it to true in the request body. forgetting to do so will result in the Payment Gateway error: payment is not in app channel.

Overall Scheme for Payment Process with the SDK​

How to perform a successful payment

Mobile SDK Payment Flow

Mobile SDK Payment Flow Explained​

  1. Create Payment Request: Start by sending a create payment request to the Payment Gateway with the appChannel flag set to true. This enables the mobile payment channel and indicates to the gateway that this is a mobile payment transaction.

  2. Initialize the SDK: Once you receive the response, pass the following parameters to the Payment SDK's processPayment method:

    • Payment ID
    • Request ID
    • Amount

    After processPayment is called, a payment form will be displayed to the end-user.

  3. User Enters Card Information: The user completes the payment by entering their card details (PAN number, CVV, expiration date) into the secure payment form.

  4. Payment Completion: After the payment is processed, the processPayment method completes execution and:

    • Returns a callback object with the payment result
    • Displays a payment finish page (either a success or failure page)

  5. Webhook Notification: The Payment Gateway sends a webhook API call to the merchant backend, informing them about the status of the payment transaction.

  6. Merchant Response: The merchant uses the callback message to react to the payment termination and update the user interface accordingly (e.g., displaying an "Order Placed" or "Item Purchased" confirmation).