Android SDK

Introduction

The UPITranzact Android SDK enables seamless UPI payment processing for merchants. This documentation will guide you through the installation and implementation of the SDK in your Android application.

Installation

To integrate the UPITranzact SDK into your Android project, add the following dependency in your build.gradle file:

implementation("com.upitranzact:upitranzact:1.1.0")

Initialization

Before starting a payment, initialize the SDK with your credentials:

UpiTranzactSDK sdk = new UpiTranzactSDK(MainActivity.this, "PUBLIC_KEY", "SECRET_KEY", "MERCHANT_ID");

• PUBLIC_KEY: Your public key provided by UPITranzact.

• SECRET_KEY: Your secret key for authentication.

• MERCHANT_ID: Your unique merchant identifier.

Starting a Payment

To initiate a UPI transaction, use the startPayment method:

sdk.startPayment("AMOUNT", // Amount to be paid
        "ORDER_ID", // Unique Order ID
        "CUSTOMER_NAME", // Customer's name
        "CUSTOMER_EMAIL", // Customer's email
        "CUSTOMER_NUMBER", // Customer's contact number
        new PaymentCallback() {
            @Override
            public void onPaymentSuccess(String order_id, String message) {
                Toast.makeText(MainActivity.this, message, Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onPaymentFailed(String order_id, String message) {
                String logMessage = message + " Order Id " + order_id;
                Toast.makeText(MainActivity.this, logMessage, Toast.LENGTH_SHORT).show();
                Log.d("PaymentFailed", logMessage);
            }
        });

Parameters

• AMOUNT: The payment amount.

• ORDER_ID: A unique order identifier generated by your app.

• CUSTOMER_NAME: The name of the customer making the payment.

• CUSTOMER_EMAIL: The customer's email address.

• CUSTOMER_NUMBER: The customer's contact number.

• PaymentCallback: Handles success and failure responses.

Payment Callback

Implement the PaymentCallback interface to handle payment responses:

• onPaymentSuccess(String order_id, String message): Called when the payment is successful.

• onPaymentFailed(String order_id, String message): Called when the payment fails.

Logging and Debugging

For debugging failed transactions, use:

Log.d("PaymentFailed", logMessage);

This helps in tracking payment issues by logging the failure message and order ID.

Support

For any issues or support, please contact UPITranzact Support.