Update Zuora HPM Error Messages

Customising error messages for fields such as “Card Number” in Zuora Hosted Payment Pages (HPM) allows you to provide clearer feedback to users during the checkout process. This guide explains how to update these messages step-by-step.

Steps to Update Error Messages

  1. Access Your Zuora Sandbox

    • Log in to your Zuora environment.

    • Always use your sandbox environment to test changes before deploying them to production.

  2. Navigate to Hosted Pages

    • From the top-right menu, go to Settings > Payments > Setup Payment Page and Payment Link.

  3. Edit the Target Hosted Page

    • Identify the Hosted Page where you want to update error messages.

    • Click on the Edit button next to the relevant Hosted Page.

  4. Locate the Client-Side Validation Section

    • Scroll down within the Hosted Page editor until you find the "Client-Side Validation" section.

    • This section contains the error messages that can be customised.

  5. Update Error Messages

    • Modify the error messages for the validated fields as needed.

    • Ensure the messages are clear and consistent

  6. Save Your Changes

    • After updating the error messages, click Save to apply the changes.


Additional Notes

  • Test Thoroughly: Perform thorough testing in the sandbox environment to verify the changes.

  • Resources: Refer to for further guidance

Last updated

Was this helpful?