Payment API

Use the payment API to execute online transactions on various Quantum Visualizer Applications.

The Payment API uses the kony.payment namespace and the following API elements.

Function Description
kony.payment.canWeMakePayment Determines if users can make payments on their device.
kony.payment.getPaymentData Returns paymentResponseData, which contains the necessary information to complete a payment transaction, in the successCallback.
kony.payment.getSupportedPaymentNetworks Returns the list of available payment networks that are supported by Apple Pay.
kony.payment.updateTransactonResponse(konyconstant) Completes the end-to-end transaction by using the payment token and informing the result of the transaction to the native platform.
 

Using Payment APIs

Invoke the kony.payment.canWeMakePayment function to check whether payments can be made on a particular device. If the callback function of the canWeMakePayment function returns true, configure the paymentData Object and then invoke the kony.payment.getPaymentData function. This invocation displays the Payment Sheet UI of the native platform. The user must fill required data in the Payment Sheet and submit the data. If the payment data is valid, the data along with a payment token is returned in the successCallback. To check the list of available payment networks, use the kony.payment.getSupportedPaymentNetworks function. Use the kony.payment.updateTransactonResponse to complete the end-to-end transaction by using the payment token and informing the result of the transaction to the native platform.

Usage Guidelines

For iOS

  1. You must have a paid Apple Developer account to use Apple Pay. To make use of the capabilities of Xcode, you must enable Apple Pay and link the required merchant ID.

  2. The PaymentButton class is not available in JavaScript. You can alternatively download the Apple Pay button resources and use them on a Quantum Visualizer button to achieve the look desired for an Apple Pay button. The Apple Pay Buttons and Resources link at the Apple Pay developer site provides you with a zip file that contains an extensive collection of approved button resources for Apple Pay. The Apple Pay Guidelines provide explanations of the permissible modifications that you can make to the provided buttons, as well as guidelines on what colors you may choose to provide the best contrast between the button and your view’s background. In general, you are not allowed to create your own button artwork, but you can stretch the provided artwork to be wider if required.
  3. If payment processing is not completed within 30 seconds, the transaction times out and the user is notified. If a timeout occurs, you must cancel the in-progress payment.
    You can refer the Apple Pay Guidelines for more information.

For Android

  1. You must install Google Play services version 11.4.x or later on your device.
  2. You must add the following tag in the Project Application Tag Child Entries section.
    <meta-data android:name="com.google.android.gms.wallet.api.enabled" android:value="true" />
  3. You must add the following tag in the Project Gradle Suffix section.
    dependencies {
    implementation 'com.google.android.gms:play-services-wallet:11.8.0' implementation 'com.android.support:support-v4:26.0.0'
    }
  4. You can refer Google Test and Deploy for more information on testing and deployment.

For a more hands-on approach on the respective features of various Payments APIs, import and preview the Quantum Payments Feature sample app by using Quantum Visualizer.