Error Handling

When you are integrating with PayU Hosted Checkout, at times you may encounter some errors due to missing mandatory parameters or hash mismatch. This section describes how to fix these issues while integrating. For a complete list of error codes, refer to Error Codes

📘

Note:

If you encounter any other issues or errors and are unable to resolve them, contact PayU Support.

Hash Mismatch

Error summary: Transaction failed due to incorrectly calculated hash parameter.

Solution: To calculate the hash parameter correctly, refer to Generate Hash.

Duplicate Transaction ID (txnid)

Error summary: The transaction ID (txnid) has been used previously or was successfully captured.

Solution: Try using a new txnid which has not been tried earlier.

📘

Note:

The txnid value must be unique for every new request made to PayU.

Invalid Amount

Error summary: Invalid amount or amount parameter was not passed.

Solution: Ensure that all the mandatory parameters are passed in the transaction request to PayU. For more information on mandatory parameters, refer to Collect Payment API - PayU Hosted Checkout or Collect Payment API - Merchant Hosted Checkout based on the integration you are using.

Incorrect Payment Details

Error summary: The debit card or credit card details passed are incorrect.

Solution: Ensure that the accurate debit card or credit card details are passed with mandatory parameters in the transaction request to PayU.

Mandatory Parameters Missing

Error summary: One or more mandatory parameters are missing in the transaction request.

Solution: Ensure that all the mandatory parameters are passed in the transaction request to PayU. For more information on mandatory parameters, refer to refer to Collect Payment API - PayU Hosted Checkout or Collect Payment API - Merchant Hosted Checkout based on the integration you are using.

You may simulate these errors and view the corrective action in the PayU API Playground too. For more information on PayU API Playground.