1. Home
  2. Docs
  3. Cirilla Payment Gateway Addons
  4. Payment Gateways
  5. HyperPay


HyperPayGatewayNative libraryios, android

Country Support:

  • Saudi Arabia
  • Jordan
  • United Arab Emirates
  • Egypt
  • Bahrain
  • Lebanon

Available Currencies:

  • all currencies


 Follow this steps:

Woocommerce website:

Add HyperPay Payments plugin to your Woocommerce:

  1. Go to WordPress Admin > Plugins > Add New from the left-hand menu
  2. In the search box type HyperPay Payments
  3. Click on Install now when you see HyperPay Payments to install the plugin
  4. Config plugin according instructions
  5. Go to Woocommerce -> Setting -> Tab Payments: You can enable one of the following payment gateways: Hyperpay Gateway, Hyperpay STCPay, Hyperpay Mada, Hyperpay ApplePay
  6. HyperPay plugin guide: https://wordpress.org/plugins/hyperpay-gateways/

Mobile app:

Android Setup

  1. Open  cirilla/android/app/build.gradle and add the following lines
    implementation(name: "oppwa.mobile-release", ext: 'aar')
    debugImplementation(name: "ipworks3ds_sdk", ext: 'aar')
    releaseImplementation(name: "ipworks3ds_sdk_deploy", ext: 'aar')
    implementation "com.google.android.material:material:1.6.1"
    implementation "androidx.appcompat:appcompat:1.5.1"
    implementation 'com.google.android.gms:play-services-wallet:19.1.0'
    implementation "androidx.browser:browser:1.4.0"


2. Open cirilla/android/app/build.gradle and make sure that the minSdkVersion is 21

3. Open your cirilla/android/app/src/main/AndroidManifest.xml, and put intent-filter inside activity

            <!-- HyperPay -->
                <action android:name="android.intent.action.VIEW" />
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.BROWSABLE" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.LAUNCHER" />
                <data android:scheme="applicationId.payment" />

Note: open cirilla/android/app/build.gradle and you will see applicationId, then copy

Example: <data android:scheme="io.rnlab.cirilla.payment" />


iOS Setup

  1. Open cirilla/ios/Podfile, and paste the following inside of it:
pod 'hyperpay_sdk', :git => 'https://github.com/ahmedelkhyary/hyperpay_sdk.git'
$static_framework = ['hyperpay_plugin']
pre_install do |installer|
  Pod::Installer::Xcode::TargetValidator.send(:define_method, :verify_no_static_framework_transitive_dependencies) {}
  installer.pod_targets.each do |pod|
      if $static_framework.include?(pod.name)
        def pod.build_type;


2. Open cirilla/ios/Runner/Info.plist, and paste the following inside of it:


Note: BundleID

Example: <string>io.rnlab.cirilla.payment</string>


NOTE: After you have fully configured. In the iOS directory need to run the command pod install

Package Setup

  1. Copy hyperpay_gateway package and add to packages folder in cirilla project.
  2. Import package in cirilla/pubspec.yaml


  path: ./packages/hyperpay_gateway

Then run flutter pub get in your project

  1. You can add 1 of 4 payment gateways or all payment gateways to cirilla/lib/payment_method.dart file
    • HyperpayGateway
    • HyperpaySTCPayGateway
    • HyperpayMadaGateway
    • HyperpayApplePayGateway
  2. ShopperResultUrl: this name must like scheme in intent-filter , CFBundleURLSchemes in info.list
    • Example: io.rnlab.cirilla.payment
  3. Language Support


import 'dart:io';
import 'package:hyperpay_gateway/hyperpay_gateway.dart';

final Map<String, PaymentBase> methods = {
  HyperpayGateway.keyHyperPay: HyperpayGateway(
    shopperResultUrl: "io.rnlab.cirilla.payment",
  HyperpaySTCPayGateway.keyStcPay: HyperpaySTCPayGateway(
    shopperResultUrl: "io.rnlab.cirilla.payment",
  HyperpayMadaGateway.keyMada: HyperpayMadaGateway(
    shopperResultUrl: "io.rnlab.cirilla.payment",
  if (Platform.isIOS)
    HyperpayApplePayGateway.keyApplePay: HyperpayApplePayGateway(
      shopperResultUrl: "io.rnlab.cirilla.payment",

Video guide:

Install plugin:

Mobile app:

Was this article helpful to you? Yes No

How can we help?