Hosted Payment pages in older Zuora Quotes version
This document provides guidance on adding Hosted Payment Pages to older versions of Zuora Quotes, specifically versions prior to 5.100.
If you have an older version of Zuora Quotes prior to version 5.100 (Q2 '13), the information below will guide you through the process of adding Hosted Payment Pages to a Salesforce Visualforce page or Salesforce Sites page. Once this is done, a sales representative in your system can submit an order that includes payment information in a PCI-compliant way.
here.
The instructions documented in this article are for users of older versions of Zuora Quotes - version 5.92 (Q1 '13 release) or earlier.Hosted Payment Pages Salesforce Page Flow
The implementation contains three VisualForce pages:
HPMSample
HPMCallback
HPMConfirm
HPMSample
This page has an HTML div element that serves as the parent container. It encapsulates all of the components and business logic required to integrate with Zuora HPM, including:
- The Hosted Payment Pages iframe.
- A Submit button that submits the HPM request to Zuora.
- JavaScript code that handles page redirect per HPM callback status.
This VisualForce page is backed by the Apex class HPMSampleController, which is responsible for:
- Loading the Hosted Payment Pages custom setting.
- Generating the signature required to load the Hosted Payment Pages iframe.
- Processing the callback error messages.
HPMCallback
The HPMCallback page is the Hosted Payment Pages hosted payment method callback page registered with the Zuora hosted payment page definition. This page validates and processes the Zuora callback, and hands over the callback results to the parent container (HPMSample).
This VisualForce page is backed by the Apex class HPMCallbackController, which is responsible for processing the callback request and validating the callback signature.
HPMConfirm
This page displays the Payment Method ID upon callback success.