Integration

Getting Started

Add below url in root project's build.gradle.

allprojects {
repositories {
maven {
url "https://phonepe.bintray.com/PhonePeIntentSDK"
}
}
}

Add below dependency in your application's build.gradle

implementation 'com.payu.phonepe:phonepe-intent:1.5.2'

Callbacks

PayUPhonePeCallback provides following callback methods.

  • onPaymentOptionFailure (String payuResponse, String merchantResponse) - Calls when payment fails.

  • onPaymentOptionSuccess (String payuResponse, String merchantResponse) - Calls when payment succeeds.

  • onPaymentOptionInitialisationFailure (int errorCode,String description) - Called for PhonePe initialisation failure.

  • onPaymentOptionInitialisationSuccess (boolean result) - Callback when PhonePe is successfully initialised.

Following are error messages w.r.t. PhonePe initialisation failure.

- ErrorCode : Description
- 1 : MERCHANT_KEY_NOT_REGISTER_FOR_PHONEPE // Merchant is not registered for
PhonePe with PayU

Create an instance of PayUPhonePeCallback like below.

PayUPhonePeCallback payUPhonePeCallback = new PayUPhonePeCallback() {
@Override
public void onPaymentOptionFailure(String payuResponse, String merchantResponse) {
//Called when Payment gets failed.
}
@Override
public void onPaymentOptionInitialisationSuccess(boolean result) {
super.onPaymentOptionInitialisationSuccess(result);
// Merchants are advised to show PhonePe option on their UI after this callback is called.
}
@Override
public void onPaymentOptionSuccess(String payuResponse, String merchantResponse) {
//Called when Payment gets successful.
}
@Override
public void onPaymentOptionInitialisationFailure (int errorCode, String description) {
//Callback thrown in case PhonePe initialisation fails.
}
};

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.

<application
<meta-data
android:name="payu_web_service_url"
android:value="https://test.payu.in" />
<meta-data
android:name="payu_post_url"
android:value="https://test.payu.in" />
</application>

Check for PhonePe Availability

SDK provides method checkForPaymentAvailability to check if PhonePe payment is available or not on device.This method is called before showing PhonePe as a checkout option.

PhonePe.getInstance().checkForPaymentAvailability(Activity activity, PayUPhonePeCallback callback, String paymentOptionHash, String merchantKey, String user_credentials)
where
PayUPhonePeCallback : the class to provide callbacks
Activity : Activity
paymentOptionHash : Payment Related Details hash
merchantKey : PayU Merchant Key
user_credentials : Provide user credentials or use "default"

To generate PaymentOption Hash visit here.

Make Payment by PhonePe

After successful initialisation of PhonePe by calling checkForPaymentAvailability method call makePayment method to make payment.

PhonePe.getInstance().makePayment(PayUPhonePeCallback callback, Activity activity, String postData,boolean isUserCacheEnabled, View customDialogView);
where
PayUPhonePeCallback : the class to provide callbacks
Activity : activity instance
postData : PayU postdata
isUserCacheEnabled : To Enable/Disable User Cache
customDialogView : Provide your Custom Progress Dialog View(Optional)

To generate Payment Hash visit here.

Sample PostData

txnid=1524122818080&productinfo=product_info&user_credentials=default&key=*****&surl=**SUCCESS_URL**&furl=**FAILURE_URL&firstname=firstname&[email protected]&amount=10&udf1=udf1&udf2=udf2&udf3=udf3&udf4=udf4&udf5=udf5&pg=CASH&bankcode=PPINTENT&hash=***PAYMENT_HASH***