FAQs - Network International

What are the steps to GO LIVE?

Configure API Keys and Outlet IDs
Perform at least one VISA and Master card successful TEST transactions and confirm go live readiness by sharing Merchant checklist.
Integration team will validate transactions and initiate Live account creation

How many days it will take for LIVE credentials to be shared?

The LIVE welcome kit will be shared within 3 - 5 business days after UAT sign off in ideal scenarios.

What are the changes needed to be done after receiving LIVE credentials?

Please change the API key and Outlet ID and the posting URL be without the “sandbox” tag.

How can we go public to customers ?

Need to perform one real VISA and Master Card transaction (pilot transactions with 1 AED or your MID currency) and send it to ecomsupport@network.global for validation and sign off

How can we get the TEST cards for sandbox?

The TEST cards are available in the docs : https://docs.ngenius-payments.com/reference#sandbox-test-environment

Is there any test cards available for Live account?

N-Genius Live account does not have any teat cards. You need to use Real cards for transactions and pilot testing

Can we enter the card customer card details from our website?

YES, but you need a PCI compliance certificate for that. You must submit a copy of the same for processing.

What are the payment channels available?

N-Genius give you almost all top payment channel options like VISA, MasterCard, Diners, Discover, American Express etc.

How can I get the API KEY?

How to get the Outlet ID?

Login to the portal ->Organisational Hierarchy-> Left you can see the outlet associated-> click on the outlet and you can see the Reference.

What is the difference between AUTH and SALE?

AUTH: Money will be on hold in customer bank account but not credited to merchant account until and unless if you do a manual capture from the portal level/ using the capture API
SALE: Money will be automatically credited to merchant account

How to create users?

How to do refund/ Partial refund?

You can do a refund from the portal level by clicking on the refund button after the transaction can be settled. Refund API can also be used for refund (Need to pass the amount and currency type). Link : https://docs.ngenius-payments.com/reference#refund-a-capture

How much time the Access token will valid?

The time is 5 minutes after that it will expire

How many Programming languages like N-Genius support?

N-Genius support leading programming languages like- Java, C#, PHP, Ruby, Node etc.

How to redirect to payment website after payment?

Include the attribute merchantAttributes.redirectUrl in the request.

When I pass 1000 value it is showing as 10?

N- Genius use minor units. (Usage : Actual value * 100 )

Can I implement the card entering feature without PCI compliance?

You have an option called WEB SDK, the customer is having an impression like he is in the same website and entering the details.

How can I implement the saved card feature?

If you have the PCI compliance, then go for Saved card feature otherwise go for tokenization. Please contact your relationship manger to enable the feature.

Is customer billing address field is a mandatory field?

Yes, it is. Customer email and billing address are mandatory ones.

Where can I find the Merchant ID/ MID?

You can get it from mail subject of the welcome kit N-Genius shared or navigate to Settings > Organization Hierarchy > MID

How to login if we forget the password?

Click on the forgot password option in the login screen. A password reset link will send to your registered email ID [Check for spam/Junk folders if you didn’t see in the inbox]. Set the password and login again. Login URL: https://portal.sandbox.ngenius-payments.com/#/login

How to create web developer or any other user?

Go to settings after login to merchant portal. Click on users and give suitable name and email ID. Select the appropriate role from user role. Select the organization.

Is it possible to change the payment page?

NO, but we can customize the payment page.

How can we customize the payment page?

Go to settings after Login. Under Branding you can apply your logo and set the theme.

How can we add new Organizational units?

Please contact your relationship manager for creating a new Organizational unit ID.

How we can activate the Webhook?

Add the webhook URL in webhooks under integrations. Once entered in sandbox please notify the team by sending an email. In sandbox we have to manually whitelist the webhook URL. In LIVE region this will get automatically whitelist once entered in the merchant portal.

How can the customer enter card details from our own website if we don’t have the PCI DSS compliance?

You can go with Hosted session [WEB SDK] integration.
Docs: https://docs.ngenius-payments.com/docs/web-sdk-integration-guide

Can we go direct LIVE without sandbox testing?

It is recommended to test using one VISA and Mastercard and once verified will give a signoff to GO public. If you have already received live credentials you can request Support team for the feasibility of skipping UAT.

What are the documents required for Tokenization feature?

You should provide indemnity letter and credit risk approval docs for tokenization feature.

Please share the steps to follow once we install the N-Genius woocommerce plugin [Single currency] and later change it to a multicurrency plugin.

In this case, the client faces some errors.
If you are using older versions N-Genius Woo-Commerce extension, can you please remove below tables.
Note: So needs to take a backup of this database mandatory.
If you want to use old data(NGO) you need to create a custom script.
The latest extension will work for fresh instances of Woo-Commerece.
Delete table : ngenius_networkinternational.
then, uninstall old extension and install new one.

Does NI provide SDK/library for PG android and iOS?

Yes, NI does provide SDK for Android, iOS and React Native.
React native - https://github.com/network-international/react-native-ngenius
Android - https://github.com/network-international/payment-sdk-android
iOS - https://github.com/network-international/payment-sdk-ios

What data need to pass to SDK in order to make the transaction?

Create-order API response will be enough to trigger SDK in react native SDK, android and iOS.

Does NI provide Sample code for SDKs?

Yes, you can find the sample code from the GitHub repo of each SDK.

Can merchant customize SDK pay page?

Yes, only if the merchant is having PCI DSS compliance certificate.

How will app get to know payment status after the transaction?

SDK does provide callback function after the transaction success/ failure , developer can make use of this callback function as their convenience.

Is SDK/library available for Flutter?

No, we don’t have flutter SDK now, but SDK can be integrated to iOS and Android using separate native SDK available on the GitHub.

Tokenization/saved card available on mobile SDK?

Saved card is not included in built in SDK, but you can save card on your database and continue transaction with API using SDK.

Is apple pay available on SDK?

Yes, apple pay can be directly integrated by using the N-Genius SDK for iOS.

N-Genius APIs can be called directly from mobile application?

No, APIS should be called from a backend language such as PHP, ASP.Net, node.js etc. Else client will be served CORS issue.

Is recurring payment available in SDK?

No, SDK doesn’t include recurring payment.it should be done from server side. But card token saving can be done using the application to store in database.

Payment page customisation can be done without PCIDSS on mobile SDK?

No SDK customisation is not possible without PCIDSS , but one ytpe of inegration method called as 'Hosted session' would be helpful to customise the payment page .
Hosted session is nothing but loading N-Genius web SDK on a webpage which can be customisable, this page can be loaded to mobile application android-webview , iOS-UIWebview.

How to configure apple pay ?

You can refer to all these steps in below video
https://drive.google.com/file/d/1U2glirdIJyjQu_Di9EN0VHeWaQyMm4Wp/view?usp=sharing
https://docs.ngenius-payments.com/reference#apple-pay-payment-method

Does NI SDK support Samsung pay?

Yes , it does. You can refer below given URL step by step documentation to integrate samsung pay. https://docs.ngenius-payments.com/reference#samsung-pay

Where to find Samsung pay integration sample code?

It can be found in github repo which is given below. https://docs.ngenius-payments.com/reference#samsung-pay

Does NISDK provides notification after payment success on mobile application?

No , SDK doesn’t provide that, but we have webhook service to acknowledge the payment and also by push notification can be done from your end after fetching order status by order retrieval API.

How to install iOS SDK?

Installation can be done by using cocoa pods or Carthage. Refer below for more info https://docs.ngenius-payments.com/reference#ios-sdk-integration-guide

How to install NI SDK on android apps?

Use below dependencies
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
dependencies {
// Required
implementation 'com.github.network-international.payment-sdk-android:payment-sdk-core:1.0.0'
// For card payment
implementation 'com.github.network-international.payment-sdk-android:payment-sdk:1.0.0'
//For samsung payment
implementation 'com.github.network-international.payment-sdk-android:payment-sdk-samsungpay:1.0.0'
}
refer below link to find latest SDK and to know more updates : https://github.com/network-international/payment-sdk-android

Does Android SDK support multi languages?

Yes , as of now android SDK is capable to handle English and Arabic.

What are the currencies supported by NI SDK?

All the currencies which are configured for the particular N-Genius account will be supported by NI SDK.

Is there any sample server API for testing purpose?

We do have one sample server application created by node js and PHP project, you can use it for demo purpose and later on move to actual API based server calls. you can find the demo server projects here :
PHP - https://github.com/network-international/sample-merchant-server-php
Javascript - https://github.com/network-international/sample-merchant-server-javascript

How to install NI SDK on react native app?

For the installation process of NI SDK on react native apps, developer can directly download package by following command
npm i @network-international/react-native-ngenius .

Is there any pre requirements for using NI SDK for react native?

Yes , If your project is using iOS deployment target 10, you need to increase it to 11.
In order to upgrade the versions do the following changes
Change the iOS deployment version in your-project/ios/Podfile as follows platform :ios, '11.0'
Open the .xcworkspacefile inside the following directory your-project/ios/yourproject.xcworkspace and change the deployment target to 11.0.

What data need to be passed to react native SDK in order to invoke payment?

Passing whole order response will take to payment activity.example below given snippet
// order is the order response received from NGenius create order API
const makeCardPayment = async () => {
try {
const resp = await initiateCardPayment(order);
} catch (err) {
console.log({ err });
}
};

How to invoke apple pay using react native NI SDK?

It can be done by below set of sample code snippet.
import { initiateApplePay } from '@network-international/react-native-ngenius';
// order is the order response received from NGenius create order API
// mid is the merchant ID that is generated in the Apple developer portal
// countryCode is the country code of the transaction country Eg: AE for UAE
const makeApplePayPayment = async () => {
try {
const resp = await initiateApplePay(order, mid, countryCode);
} catch (err) {
console.log({ err });
}
};

How to invoke Samsung pay using NI SDK in react native?

It can be done by below set of sample code snippet.
import { initiateSamsungPay } from '@network-international/react-native-ngenius';
// order is the order response received from NGenius create order API
// merchantName is the name of merchant's establishment
// serviceId is the serviceId that is generated in the Samsung Pay developer portal
const makeSamsungPayPayment = async () => {
try {
const resp = await initiateSamsungPay(order, merchantName, serviceId);
} catch (err) {
console.log({ err });
}
};

How to configure SDK language in react native?

ans. language configuration can be done by below code snipet.
import { configureSDK } from '@network-international/react-native-ngenius';
configureSDK({
language: isEnglish ? 'en' : 'ar'
});

How to show/hide ordder amount in react native SDK?

It can be done by :
import { configureSDK } from '@network-international/react-native-ngenius';
configureSDK({
shouldShowOrderAmount: true/false
});
//true for show amount
//false for hide amount

How to check if samsung pay is enabled on react native NI SDK?

By using below lines of code , it can be found.
import { isSamsungPaySupported } from '@network-international/react-native-ngenius';
const isSamsungPayEnabled = await isSamsungPaySupported();

How to check if apple pay is enabled on NI SDK react native app?

ans . please use following code to get the confirmation.
import { isApplePaySupported } from '@network-international/react-native-ngenius';
const isApplePayEnabled = await isApplePaySupported();

Does NI SDK for Ios has multi language compatibility?

No, as of now only android has multi language support with both English and Arabic.

Ecommerce Integration

Ecommerce Integration

For Technical Support: