Build the Payment Params

(Mandatory Step)

Step 2: Build the Payment Params
To initiate a payment, your app will need to send transactional information to the Checkout Pro SDK. To pass this information, build a payment parameter object as below
Java
Kotlin
Java
PayUPaymentParams.Builder builder = new PayUPaymentParams.Builder(); 
builder.setAmount(<String>)  
        .setIsProduction(<Boolean>)  
        .setProductInfo(<String>)   
        .setKey(<String>)      
        .setPhone(<String>)      
        .setTransactionId(<String>)  
        .setFirstName(<String>) 
        .setEmail(<String>) 
        .setSurl(<String>) 
        .setFurl(<String>) 
        .setUserCredential(<String>) 
        .setAdditionalParams(<HashMap<String,Object>>); //Optional, can contain any additional PG params  
PayUPaymentParams payUPaymentParams = builder.build(); 
Kotlin
 val payUPaymentParams = PayUPaymentParams.Builder() 
    .setAmount(<String>)      
    .setIsProduction(<Boolean>)  
    .setKey(<String>)       
    .setProductInfo(<String>)   
    .setPhone(<String>)  
    .setTransactionId(<String>) 
    .setFirstName(<String>) 
    .setEmail(<String>) 
    .setSurl(<String>) 
    .setFurl(<String>) 
    .setUserCredential(<String>) 
    .setAdditionalParams(<HashMap<String,Any?>>) //Optional, can contain any additional PG params 
    .build()  
For Recurring Payments(SI)
If you are integrating SI, then generate below payment params additionally
Java
Kotlin
Java
PayUSIParams siDetails  = new PayUSIParams.Builder()
                            .setIsFreeTrial(binding.layoutSiDetails.spFreeTrial.isChecked()) //set it to true for free trial. Default value is false  
                            .setBillingAmount(binding.layoutSiDetails.etBillingAmountValue.getText().toString())
                            .setBillingCycle(PayUBillingCycle.valueOf(binding.layoutSiDetails.etBillingCycleValue.getSelectedItem().toString()))
                            .setBillingInterval(Integer.parseInt(binding.layoutSiDetails.etBillingIntervalValue.getText().toString()))
                            .setPaymentStartDate(binding.layoutSiDetails.etPaymentStartDateValue.getText().toString())
                            .setPaymentEndDate(binding.layoutSiDetails.etPaymentEndDateValue.getText().toString())
                            .setRemarks(binding.layoutSiDetails.etRemarksValue.getText().toString())
                            .build();
Kotlin
val siDetails = PayUSIParams.Builder()
                .setIsFreeTrial(sp_free_trial.isChecked) //set it to true for free trial. Default value is false
                .setBillingAmount(et_billingAmount_value.text.toString())
                .setBillingCycle(PayUBillingCycle.valueOf(et_billingCycle_value.selectedItem.toString()))
                .setBillingInterval(et_billingInterval_value.text.toString().toInt())
                .setPaymentStartDate(et_paymentStartDate_value.text.toString())
                .setPaymentEndDate(et_paymentEndDate_value.text.toString())
                .setRemarks(et_remarks_value.text.toString())
                .build()
Refer here for more details on all params used in PayUSIParams. After creating above PayUSIParams object, set it in the PayUPaymentParams object. For SI, complete PayUPaymentParams looks like below
Java
Kotlin
Java
PayUPaymentParams.Builder builder = new PayUPaymentParams.Builder(); 
builder.setAmount(<String>)  
        .setIsProduction(<Boolean>)  
        .setProductInfo(<String>)   
        .setKey(<String>)      
        .setPhone(<String>)      
        .setTransactionId(<String>)  
        .setFirstName(<String>) 
        .setEmail(<String>) 
        .setSurl(<String>) 
        .setFurl(<String>) 
        .setUserCredential(<String>) 
        .setAdditionalParams(<HashMap<String,Object>>); //Optional, can contain any additional PG params  
        .setPayUSIParams(siDetails);
PayUPaymentParams payUPaymentParams = builder.build(); 
Kotlin
 val payUPaymentParams = PayUPaymentParams.Builder() 
    .setAmount(<String>)      
    .setIsProduction(<Boolean>)  
    .setKey(<String>)       
    .setProductInfo(<String>)   
    .setPhone(<String>)  
    .setTransactionId(<String>) 
    .setFirstName(<String>) 
    .setEmail(<String>) 
    .setSurl(<String>) 
    .setFurl(<String>) 
    .setUserCredential(<String>) 
    .setAdditionalParams(<HashMap<String,Any?>>) //Optional, can contain any additional PG params 
    .setPayUSIParams(siDetails)
    .build()  
Payment Param Definitions
Parameter 
Type 
Description 
Data Type & Validation 
Mandatory 
Amount 
String 
Total transaction amount  
Can not be null or empty and should be valid double stringified eg, “100.0” 
Yes 
Product info 
String 
Information about product 
Can not be null or empty 
Yes 
Key 
String 
Merchant key received from PayU 
Can not be null or empty 
Yes 
isProduction 
Boolean 
Environment of SDK. Set to true for Production else false 
Should be a Boolean value. Default value is true 
No 
Phone 
String 
Customer’s phone number 
Should be of 10 digits 
No 
TransactionId 
String 
It should be unique for each transaction 
Should be unique for each transaction 
Yes 
First Name 
String 
Customer’s first name 
Can not be null or empty 
Yes 
Email 
String 
Customer’s email id 
Can not be null or empty 
Yes 
Surl 
String 
When the transaction is successful, PayU will load this url and pass transaction response 
Can not be null or empty 
Yes 
Furl 
String 
When the transaction is a failure, PayU will load this url and pass transaction response 
Can not be null or empty 
Yes 
User Credential 
String 
This is used for the store card feature. PayU will store cards corresponding to passed user credentials and similarly, user credentials will be used to access previously saved cards 
Should be a unique value 
Format : <merchantKey>:<userId> 
Here,  
UserId is any id/email/phone number to uniquely identify the user  
No 
PayUSIParams
Object of PayUSIParams
This contains SI Details
Object of PayUSIParams
No
Additional parameters are optional parameters such as UDF (user defined fields), static hashes, etc. More details on static hash generation and passing are mentioned in the hash generation section. 

Integration

Additional Params

Last updated 1 month ago

Parameter	Type	Description	Data Type & Validation	Mandatory
Amount	String	Total transaction amount	Can not be null or empty and should be valid double stringified eg, “100.0”	Yes
Product info	String	Information about product	Can not be null or empty	Yes
Key	String	Merchant key received from PayU	Can not be null or empty	Yes
isProduction	Boolean	Environment of SDK. Set to true for Production else false	Should be a Boolean value. Default value is true	No
Phone	String	Customer’s phone number	Should be of 10 digits	No
TransactionId	String	It should be unique for each transaction	Should be unique for each transaction	Yes
First Name	String	Customer’s first name	Can not be null or empty	Yes
Email	String	Customer’s email id	Can not be null or empty	Yes
Surl	String	When the transaction is successful, PayU will load this url and pass transaction response	Can not be null or empty	Yes
Furl	String	When the transaction is a failure, PayU will load this url and pass transaction response	Can not be null or empty	Yes
User Credential	String	This is used for the store card feature. PayU will store cards corresponding to passed user credentials and similarly, user credentials will be used to access previously saved cards	Should be a unique value Format : <merchantKey>:<userId> Here, UserId is any id/email/phone number to uniquely identify the user	No
PayUSIParams	Object of PayUSIParams	This contains SI Details	Object of PayUSIParams	No