Overview

This release also introduces several UI enhancements and developer-focused improvements to simplify testing, environment configuration, and payment customization workflows.

Release Date: March 2026
Platform: iOS
Version: v7.0.0-beta

---

Distribution & Testing

Version 7.0.0 is available for early access testing through TestFlight.

Internal testers automatically receive builds, while external testers can join using a TestFlight invitation link shared by the team.

TestFlight Setup

Note: TestFlight builds expire 90 days after upload.

---

Unified Payment Page & Apple Pay

The SDK now includes a new Unified Payment Page that consolidates all supported payment methods into a single checkout experience.

Apple Pay is now fully integrated into the unified flow and is displayed automatically when enabled on the gateway outlet.

Supported Payment Methods

• Credit and Debit Cards
• Apple Pay
• AANI Pay
• Click to Pay

---

Apple Pay Support

When Apple Pay is enabled on the gateway outlet, the Apple Pay button is displayed automatically within the Unified Payment Page.

Customers authenticate using:

• Face ID
• Touch ID

The encrypted Apple Pay token is securely sent to the gateway for processing.

Note: The outlet must have the APPLE_PAY wallet type enabled. The DIRECT_APPLE_PAY flow is not supported by the SDK.

---

Dynamic Apple Pay Merchant ID Selection

The demo application automatically selects the correct Apple Pay merchant identifier based on:

• environment,
• region,
• and gateway configuration.

Supported regions include:

• UAE
• KSA

---

Unified Payment Page Preview

---

AANI QR Code Payments

Customers can now complete payments using AANI QR codes as an alternative to alias-based payment flows.

The QR code is generated server-side and displayed for scanning using supported banking applications.

Payment Flow

1. User selects QR Code from the AANI payment type dropdown
2. User taps Generate QR Code
3. SDK generates the QR code server-side
4. QR code is displayed with a 5-minute countdown timer
5. Customer scans the QR code using their banking application
6. SDK polls payment status every 5 seconds
7. Payment result is displayed automatically

---

AANI QR Payment Flow

flowchart TD

    %% --- Customer Actions ---
    subgraph Customer Interaction
        A["Select QR Code<br>from AANI payment dropdown"]
        B[Tap Generate QR Code]
        F["Scan QR Code<br>using banking app"]
    end

    %% --- QR Code Generation ---
    subgraph QR Code Generation
        C["SDK requests QR code<br>from server"]
        D[QR code generated]
        E["Display QR code<br>+ 5-minute timer"]
    end

    %% --- Payment Processing ---
    subgraph Payment Processing
        G["Poll payment status<br>(every 5 seconds)"]
        H{Payment successful?}
    end

    %% --- Expiry Handling ---
    subgraph Expiry Handling
        K{QR code expired?}
        L[Prompt user to regenerate QR code]
    end

    %% --- Outcome ---
    subgraph Payment Outcome
        I[Display payment success]
        J[Display payment failure]
    end

    %% --- Flow ---
    A --> B
    B --> C
    C --> D
    D --> E

    E --> F
    E --> K

    F --> G
    G --> H

    H -- Yes --> I
    H -- No --> J

    K -- Yes --> L
    K -- No --> F

---

AANI QR Screens

---

Label Updates

---

Click to Pay Enhancements

This release introduces several improvements to the Click to Pay experience.

---

Click to Pay Screens

---

Payment Page UI Refresh

Several improvements have been made to the payment experience to improve clarity and usability.

UI Improvements

• Order summary label added
• Larger and bolder amount formatting
• New CVV tooltip interaction
• Clickable Terms and Conditions links
• mada card logo support added
• Fully tappable AANI payment rows
• Simplified payment option layout

---

Payment Result Screen Redesign

The payment success and failure screens have been redesigned to improve visual clarity and consistency.

Result Screen Updates

• Green success titles
• Red failure titles
• Updated footer layout
• Card provider branding
• Clickable legal links

---

Payment Result Screen Preview

---

Localization

New French Language Support

French translations have been added across all SDK payment flows, including:

• Card payments
• AANI Pay
• Click to Pay
• Payment results
• Visa instalments
• Partial authorisation flows

---

Arabic Translation Updates

Updated Arabic translations include:

• AANI QR flows
• Payment messages
• Mobile number fields
• Reference number terminology
• Transaction date terminology

---

Updated English Terminology

---

Technical Updates

---

Demo App — Storefront & Environment QR Import

The demo application now includes QR-based environment configuration support.

Developers and testers can instantly import merchant credentials by scanning QR codes directly within the application.

---

Environment Management Features

• Add merchant environments
• Edit saved environments
• Delete environments
• Activate environments dynamically
• Import configurations using QR codes

---

Adding an Environment

Two methods are supported:

---

Supported Environment Fields

---

Configuration and Storefront Screens Preview

---

Additional Notes

Environment configurations are stored locally within the demo application and are not part of the SDK itself.

---

This release notes document was generated from the release/7.0.0-beta branch for iOS SDK version 7.0.0.