Integration

Search…
Integration
PayU UPI SDK Integration
Onboarding Requirements
To start transacting through Google Pay, please register yourself on Google Pay using the following Google Onboarding, In this registration process please add the Merchant VPA Ids created by PayU for you. In the case of multiple VPAs, all of them needs to be registered. For any queries regarding the same, drop an email to "[email protected]" team and we will get back to you.
Gradle Dependency
Adding the PayU Upi SDK (available at Maven Central)is a fairly straight forward process:
1
 implementation 'in.payu:upisdk:1.5.3'
Copied!
If you are getting the below compile error.
Android resource linking failed /Users/sample/AndroidStudioProjects/MyApp/app/build/intermediates/merged_manifests/debug/AndroidManifest.xml:18: error: unexpected element  found in <manifest>
Manifest merger failed with multiple errors, see logs
  Upon expanding the Merged Manifest view you would then see an additional error:
Error: Missing 'package' key attribute on element package
It means you need to fix your Gradle plugin, refer to this document.
As UPI sdk is compiled on sdk version 29 with androidx support , it might happen that your app and SDK have common dependencies that lead to compile-time errors due to the duplicity of classes.
In such cases, you need to define resolutionStrategy on your project/App's build.gradle. For more details, Gradle doc.
1
configurations.all {
Copied!
1
    resolutionStrategy {
2
        force "path of conflicting library 1"
3
        force "path of conflicting library 2"
4
        ...
5
    }
6
}
Copied!
Generate Payment Hash
Refer this document, Generate Hash to generate the hash.
Every transaction (payment or non-payment) needs a hash by the merchant before sending the transaction details to PayU. This is required for PayU to validate the authenticity of the transaction. This should be done on your server.
Payment Request Post Data
Ways to generate Postdata:
By UPI SDK itself - recommended if using UPI SDK alone.
By using  PG Sdk library.
Post Data can be generated by using 
1
​
2
        PaymentParamsUpiSdk mPaymentParamsUpiSdk = new PaymentParamsUpiSdk();
3
        mPaymentParamsUpiSdk.setKey(inputData); //Your Merchant Key
4
​
5
        mPaymentParamsUpiSdk.setProductInfo("product info");
6
        mPaymentParamsUpiSdk.setFirstName("first name"); //Customer First name
7
        mPaymentParamsUpiSdk.setEmail("email"); //Customer Email
8
        mPaymentParamsUpiSdk.setTxnId("txnId"); //Your transaction id
9
        mPaymentParamsUpiSdk.setAmount("Transaction Amount"); //Your transaction Amount(In Double as String)
10
        mPaymentParamsUpiSdk.setSurl("success url");
11
        mPaymentParamsUpiSdk.setFurl("failure url");
12
        mPaymentParamsUpiSdk.setUdf1("udf1");
13
        mPaymentParamsUpiSdk.setUdf2("udf2");
14
        mPaymentParamsUpiSdk.setUdf3("udf3");
15
        mPaymentParamsUpiSdk.setUdf4("udf4");
16
        mPaymentParamsUpiSdk.setUdf5("udf5");
17
        mPaymentParamsUpiSdk.setVpa("vpa"); //In case of UPI Collect set customer vpa here
18
        mPaymentParamsUpiSdk.setUserCredentials("user credentials");
19
        mPaymentParamsUpiSdk.setOfferKey("offer key");
20
        mPaymentParamsUpiSdk.setPhone("phone number");//Customer Phone Number
21
        mPaymentParamsUpiSdk.setHash("hash");//Your Payment Hash
22
​
23
        String postDataFromUpiSdk = new PostDataGenerate.PostDataBuilder(this).
24
                setPaymentMode(UpiConstant.UPI).setPaymentParamUpiSdk(mPaymentParamsUpiSdk).
25
                build().toString();
26
​
Copied!
1
 /**
2
     * Callback of payment availability while doing through UPISDK.
3
     */
4
    PayUUPICallback payUUpiSdkCallback = new PayUUPICallback() {
5
​
6
        @Override
7
        public void isPaymentOptionAvailable(boolean isAvailable, PaymentOption paymentOption) {
8
            super.isPaymentOptionAvailable(isAvailable, paymentOption);
9
            switch (paymentOption) {
10
                case PHONEPE:
11
                   //check whether you show Phonepe or not using isAvailable.
12
                    break;
13
                case SAMSUNGPAY:
14
                 //check whether you show Samsung Pay or not using isAvailable
15
                    break;
16
            }
17
        }
18
    };
Copied!
1
 //Checking the payment availability for PHONEPE, SAMSUNGPAY and Google Pay.
2
 // It will return the availability on payUUpiSdkCallback isPaymentOptionAvailable() method.
3
   Upi upi = Upi.getInstance();
4
        upi.checkForPaymentAvailability(this, PaymentOption.PHONEPE, payUUpiSdkCallback, mPayUHashes.getPaymentRelatedDetailsForMobileSdkHash(), mPaymentParamsUpiSdk.getKey(), mPaymentParamsUpiSdk.getUserCredentials());
5
        upi.checkForPaymentAvailability(this, PaymentOption.SAMSUNGPAY, payUUpiSdkCallback, mPayUHashes.getPaymentRelatedDetailsForMobileSdkHash(), mPaymentParamsUpiSdk.getKey(), mPaymentParamsUpiSdk.getUserCredentials());
6
        upi.checkForPaymentAvailability(this, PaymentOption.TEZ, payUUpiSdkCallback, mPayUHashes.getPaymentRelatedDetailsForMobileSdkHash(), mPaymentParamsUpiSdk.getKey(), mPaymentParamsUpiSdk.getUserCredentials());
7
​
Copied!
Set up for Test/Sandbox Merchant
If you are using the SDK with a test merchant, please provide this metadata value to the manifest file else removed these lines below.
1
    <application
2
    <meta-data
3
        android:name="payu_web_service_url"
4
        android:value="https://test.payu.in" />
5
​
6
    <meta-data
7
        android:name="payu_post_url"
8
        android:value="https://test.payu.in" />
9
​
10
</application>
Copied!
Payment Options
Following Payment Options are currently supported by UPI sdk.
1
PaymentOption.PHONEPE: Payment using PhonePe
2
PaymentOption.SAMSUNGPAY: Payment using Samsung pay.
3
PaymentOption.TEZ: Payment using Google Pay.
4
PaymentOption.UPI_INTENT: Payment using UPI apps installed on device.i,e, Intent flow..
5
PaymentOption.UPI_COLLECT: UPI payment through web flow.
Copied!
Dependency for PhonePe
To make payment through PhonePe, you must have to add  payu phonepe dependency.
Gradle
Add below url in root project build.gradle:
1
allprojects {
2
    repositories {
3
        maven {
4
            url "https://phonepe.mycloudrepo.io/public/repositories/phonepe-intentsdk-android"
5
        }
6
    }
7
}
Copied!
Add below dependency to project build.gradle
1
implementation 'in.payu:phonepe-intent:1.6.0'
Copied!
​
Dependency for Google pay
To make payment through Google Pay, you must have to add PayU Google Pay dependency.
Gradle
Add below dependency to project build.gradle
1
implementation 'in.payu:payu-gpay:1.4.0'
Copied!
Dependency for Samsung pay
To make payment through Samsung Pay, you must have to add  payu samsung pay dependency.
Gradle
Add below dependency to project build.gradle
1
implementation 'com.payu.samsungpay:samsungpay:1.0'
Copied!
​
Generate Postdata Using upi-sdk
Refer this document, SDK Integration,  Refer PaymentPostParams class to generate Postdata.
Once you check the payment the availability of Payment, you could go ahead to make the payment.
Callbacks
onPaymentFailure(String payuResult,String merchantResponse) - Calls when payment fails.
onPaymentSuccess(String payuResult,String merchantResponse) - Calls when payment succeeds.
onUpiErrorReceived(int errorCode,String errorMessage) - Called for error on UPI SDK where,
​
Following are error messages w.r.t. Samsung Pay initialisation failure.
​
1
- Error Codes      : Error messages 
2
​
3
- 1                : VENDOR_NOT_SUPPORTED   // Device Vendor is not supported
4
- 2                : DEVICE_NOT_SUPPORTED   // Device is not supported 
5
- 3                : APP_VERSION_MISMATCH   // Samsung Pay version doesn't meet requirements 
6
- 4                : COUNTRY_NOT_SUPPORTED  // Country of device origin is not supported by Samsung Pay 
7
- 5                : MERCHANT_KEY_NOT_REGISTER_FOR_SAMSUNG_PAY        // Merchant is not registered for 
8
                                                                         Samsung Pay with PayU 
9
- 6                : CONTEXT_NULL           // Context is null
10
- 7                : PAYMENT_ID_NOT_PRESENT // Check your postdata
Copied!
​
In case below error is received while processing payment please check your Payment Post Data/ Payment hash
1
- code        : 1002 
2
- errormsg    : MERCHANT_INFO_NOT_PRESENT 
3
- code        : 1004
4
- errormsg    : INVOKING_APP_NOT_INSTALLED_CODE //Selected app is not installed on device.
5
- code        : 1005
6
- errormsg    : INVOKING_APP_NOT_ONBOARDED_CODE //Uses has not onboarded on UPI on selected application
Copied!
isPaymentOptionAvailable(boolean isAvailable, PaymentOption paymentOption) 
Merchant must check for Samsung Pay/PhonePe payment option availability on the customer device before showing Samsung Pay/PhonePe as payment option on their checkout page.
onVpaEntered(String vpa, IValidityCheck iValidityCheck)
For Generic Intent, we need to calculate validateVpahash using vpa and provide to verifyVpa method of iValidityCheck.
Hash can be calculated using webservice command "validateVpa" as mentioned here.

1
        PayUUPICallback payUUpiSdkCallbackUpiSdk = new PayUUPICallback() {
2
        @Override
3
        public void onPaymentFailure(String payuResult, String merchantResponse) {
4
            super.onPaymentFailure(payuResult, merchantResponse);
5
​
6
         //Payment failed
7
        }
8
        @Override
9
        public void onPaymentSuccess(String payuResult, String merchantResponse) {
10
            super.onPaymentSuccess(payuResult, merchantResponse);
11
            //Payment succeed
12
        }
13
​
14
        @Override
15
        public void onVpaEntered(String vpa, IValidityCheck iValidityCheck) {
16
            super.onVpaEntered(vpa, iValidityCheck);
17
            String input = "payu merchant key" + "|validateVPA|" + vpa + "|" + "payu merchant salt";
18
            iValidityCheck.verifyVpa(calculateHash(input));
19
        }
20
​
21
        @Override
22
        public void onUpiErrorReceived(int code, String errormsg) {
23
            super.onUpiErrorReceived(code, errormsg);
24
          //Any error on upisdk
25
        }
26
​
27
        };
Copied!
Make Payment
To make the payment, first you need to create UpiConfig and provide mandatory parameters, merchant key and postdata, that we described above.
1
  UpiConfig upiConfig = new UpiConfig();
2
  upiConfig.setMerchantKey("merchant key");
3
  upiConfig.setPayuPostData("postdata");// that we generate above
4
  //In order to set CustomProgress View use below settings
5
  upiConfig.setProgressDialogCustomView(<Custom Progress Dialog View>);
Copied!
Make Intent Payment by Specific App
In order to make Intent Payment by Specific UPI app kindly set the desired name of UPI app in upiConfig object as below.
1
upiConfig.setPackageNameForSpecificApp("<UPI_PACKAGE_ID>");
2
where UPI_PACKAGE_ID can be any of UPI apps like - 
3
com.phonepe.app(PhonePe),
4
com.google.android.apps.nbu.paisa.user(GPay) etc.
Copied!
Disable Manual VPA Fallback Option from Generic Intent Tray
You can disable the Manual VPA Fallback option from Generic Intent tray from backend as well as from frontend. 
In order to disable it from front end, set UpiConfig.TRUE to setDisableIntentSeamlessFailure flag of UpiConfig.
​
1
upiConfig.setDisableIntentSeamlessFailure(UpiConfig.FALSE/UpiConfig.TRUE);
Copied!
Provide the PayUUPICallback instance and Upiconfig object to Upi makepayment() method.
1
Upi upi = Upi.getInstance();
2
upi.makePayment(payUUpiSdkCallbackUpiSdk, activity, upiConfig);
Copied!
For Device API Level 19, You must enable Gms provider service and set gmsProviderUpdatedStatus of UpiConfig below. For more detail.
1
upiConfig.setGmsProviderUpdatedStatus(UpiConfig.DISABLE/UpiConfig.ENABLE);
Copied!
VPA Validation
You can validate a VPA of its own using the SDK. You need to create a hash through this below command.
Hash can be calculated using Webservice command "validateVpa" as mentioned here​
1
sha512(key|command|var1|salt)
2
where
3
key=YOUR KEY
4
command=validateVPA
5
salt= YOUR SALT
6
var1= the vpa, you want to validate
Copied!
This feature available from UPI SDK version >=1.2.0
After creating the hash, you need to call getCommandResponse() method of Upi with the postdata.
1
Upi upi = Upi.getInstance();
2
upi.getCommandResponse(Activity, postdata, PayUUPICallback);
Copied!
Create postdata for VPA validation
1
String postData= "key=" + Your Key + "&var1=" + {VPA for validation} + "&command=validateVPA&" + "hash=" + {Hash you generated above}
Copied!
You will get the response to onCommandResponse(String payUCommandResponse, String command) of PayUUPICallback.
PayUCommandResponse Sample
1
{"status":"SUCCESS",
2
"vpa":"VPA you are validating",
3
"isVPAValid":1, //It will be 0(Invalid) or 1(Valid)
4
"payerAccountName":"Payer Name corresponding to the VPA"}
Copied!
Verify the transaction through Webhooks or polling 
 Once you get the response from SDK, make sure to confirm it with the PayU server.
It is recommended to implement the PayU Webhook or backend verify call from your backend.
Implementation of PayU WebHook

Webhook is a server-to-server callback. Once this feature is activated for merchants, PayU would send an S2S response, in addition to SDK callback, to the merchant. It is recommended for the merchant to process the transaction order status – based upon the S2S response and not via the Browser Redirection/SDK callback response to ensure optimum translation outcomes. 
Refer to this document, for Webhook implementation.
There is another option to verify payment through polling, the transaction status after the SDK callback from your backend. 
Staging Environment Configurations
To Test on Staging Environment(test.payu.in) use your Staging Env. merchant key and salt and add below configurations in your application manifest.
1
<meta-data android:name="payu_debug_mode_enabled" android:value="true" />
2
<meta-data android:name="payu_web_service_url" android:value="https://test.payu.in" />
3
<meta-data android:name="payu_post_url" android:value="https://test.payu.in" />
Copied!
​