hyper_pay_payment 1.0.17

HYPER PAY FLUTTER PLUGIN , Payment method : VISA, MASTER, MADA, APPLE PAY

hyper_pay_flutter_plugin

---

---

Documenation

HyperPay Integration Guide

---

---

GET START Hyper Pay Payment

Android Config

• Add JitPack to your build.gradle (Project-level) line :

 maven { url 'https://jitpack.io' } // important line

• example

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' } // important line
    }
}

in newer Gradle versions (settings.gradle or settings.gradle.kts), make sure JitPack is added like this: gradle

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' } // important line
    }
} 

---

---

IOS Configuration

VISA/MADA/MASTER

1- update cocoapods

sudo gem install cocoapods

2- cd flutter project/

flutter clean
flutter pub get

3- cd projectPathFolder/ios/

rm -rf Podfile.lock Pods
pod install
pod install --repo-update

or

rm -rf Podfile.lock Pods 
pod install --repo-update

4- edit podfile :

• set the source of pods is CocoaPods trunks, by write this in first lines in podfile

source 'https://github.com/CocoaPods/Specs.git' 

• set platform sdk ios, to be written in first line of podfile

platform :ios, '15.0'

• set at last line of file podfile, the ios device min to run to be:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
     config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
    end
  end
end

5- set schema url , by editing file info.plist :

• replace <<com.example.app>> with your bundle id then append with <<.payment>>

	<key>CFBundleURLTypes</key>
	<array> 
		<dict>
			<key>CFBundleTypeRole</key>
			<string>Editor</string>
			<key>CFBundleURLSchemes</key>
			<array>
				<string>com.example.myapp.payment</string>
			</array>
		</dict>
	</array>

• use this value "com.example.myapp.payment" to be set in

    var channelRequest = HyperpayChannelRequest ( );
    channelRequest.shopperResultUrl =   "com.example.myapp.payment";

• after adding schema you also need flutter clean second time
• cd flutter project/

flutter clean
flutter pub get

• after set schema, make install pod again
• cd projectPathFolder/ios/

pod install

6- remove app by uninstall from your device

APPLEPAY Config:

• enable apple pay Capabilities and follow certificate

---

---

Create Payment Type : VISA/MASTER/MADA

Step 1 : Generate Checkout ID

• First generate the checkout id from your server side, using your own ceradential you getted from Hyperpay support team

Step 2 : Open UI Checkout Using Flutter Plugin

• Payment Method : VISA/MASTER/MADA

Choose Brand Type

Case : Auto Detect Brand Type:

                /// init request channel
                var channelRequest = HyperpayChannelRequest ( );
                channelRequest.shopperResultUrl =   "com.example.myapp.payment";  //contact hyperpay support to get merchantId
                channelRequest.merchantId =  "merchant.com.example.myapp";  //contact hyperpay support to get merchantId 
                channelRequest.checkoutId = "**************"; //get from your server side 
                channelRequest.amount =  1;
                channelRequest.isTest = false ; //false means it's live

                await HyperPayPayment.newPayment(channelRequest : channelRequest, onComplete: (bool isSuccess) {

                  setState(() {
                    isPaymentSuccess = isSuccess;
                  });

                } );

Case : Choose Single Brand Type:

• set the of "brandName" to one of documentation types.
• Example validate to enter Visa number

                /// init request channel
                var channelRequest = HyperpayChannelRequest ( );
                channelRequest.shopperResultUrl =   "com.example.myapp.payment";  //contact hyperpay support to get merchantId
                channelRequest.merchantId =  "merchant.com.example.myapp";  //contact hyperpay support to get merchantId
                channelRequest.brandName = "VISA";  // follow documentation to get brand name, example : VISA/MASTER/MADA 
                channelRequest.checkoutId = "**************"; //get from your server side 
                channelRequest.amount =  1;
                channelRequest.isTest = false ; //false means it's live

                await HyperPayPayment.newPayment(channelRequest : channelRequest, onComplete: (bool isSuccess) {

                  setState(() {
                    isPaymentSuccess = isSuccess;
                  });

                } );

• Note: the above code will return the result in boolean type "isSuccess", when success that's means the payment completed without any failure, But Notice you must call your server side to check status of this checkoutID if the money payed or not.

Step 3 : Check Status Of Payment

• Checker By Your Server: Call your server side to check after completed payment in previous step, if this checkout id is completed and success charge money or not.

Screenshot Visa Payment

• Android Visa Screens :

• IPhone Visa Screens :

---

---

Apple Pay / Hyperpay :

First Config Apple Pay:

• first generate the checkout id from your server side, using your own ceradential you getted from Hyperpay support team
• create capilities of xcode "apple pay"
• create merchant id in apple store connect
• Contact hyperpay support to get the "merchant.cer" and "processing.cer" to be replaced into your apple store account

Second Code Open UI Apple Pay Dialog :

• code dart

                /// init request channel
                var channelRequest = HyperpayChannelRequest ( );
                channelRequest.shopperResultUrl =   "com.example.myapp.payment";  //contact hyperpay support to get merchantId
                channelRequest.merchantId =  "merchant.com.example.myapp";  //contact hyperpay support to get merchantId
                channelRequest.brandName = "APPLEPAY";  
                channelRequest.checkoutId = "**************"; //get from your server side 
                channelRequest.amount =  1;
                channelRequest.isTest = false ; //false means it's live

                await HyperPayPayment.newPayment(channelRequest : channelRequest, onComplete: (bool isSuccess) {

                  setState(() {
                    isPaymentSuccess = isSuccess;
                  });

                } );

Step Three : Check Status Of Payment

• call your server side to check after completed payment, if this checkout id is completed and success charge money or not.

Video

the above video is live transactions

---

---

Developed By Company MASARAT

Company

MASARAT Linkedin Website

Team Member

	Teach Lead Elamir Mahmoud Linkedin at MASARAT company
	Created by Abdallah Mahmoud Linkedin at MASARAT company
	Backend by Hager Hamdy Linkedin at MASARAT company
	Tested by Samaa Hazem Linkedin at MASARAT company
	Flutter Developer Integration Ahmed Moharam Linkedin at MASARAT company

---

---

MASARAT Proprietary Software License

MASARAT Proprietary Software License

Copyright © 2025 MASARAT Company. All rights reserved.

This software is licensed, not sold. By downloading or using this software, you agree to the following terms:

1. Permitted Use
   You are granted a non-exclusive, non-transferable, revocable license to download and use this software only in its original form for personal or internal business purposes.

2. Restrictions
   You may not, under any circumstance:
   - Copy or reproduce any part of the software or its source code.
   - Modify, adapt, translate, reverse-engineer, decompile, or disassemble the software.

3. Ownership
   All rights, title, and interest in and to the software remain the exclusive property of MASARAT.

4. Termination
   This license is effective until terminated. It will terminate automatically without notice if you breach any of its terms. Upon termination, you must cease all use and delete all copies.

5. No Warranty
   This software is provided "as is", without warranty of any kind. MASARAT shall not be liable for any damages resulting from its use.