Skip to main content

Advanced Hosted Payment Pages Integration


Advanced Hosted Payment Pages Integration


After performing the Basic Hosted Payment Pages Integration, you can further customize the reference implementation, including: 

  • Changing the size of the iframe
  • Changing the error message text
  • Appending extra parameters to the iframe URL

Change the Size of the Hosted Payment Pages iframe

You can change the size Hosted Payment Pages iframe by modifying the width and height of the iframe in the HPMSample page: 

<iframe id="z_hppm_iframe" name="z_hppm_iframe" width="100%"
height="420" src="{!iframeSrc}" frameborder="0">

Change the Error Message Text

The error code and error message mapping is listed in the Apex class ErrorCodeMapping. You can modify the message text in this class.

Important: Do not change the error code.  

Append Extra Parameters to the iframe URL

You can customize the Hosted Payment Pages iframe functionality by providing extra Hosted Payment Pages parameters. To do this, you must specify the parameters and their values in Apex method HPMSampleController.getExtraParameters()

     * Specify extra HPM parameters that can be used to (1) Preload field values (2) Override default HPM properties.  Please see 
     * HPM Implementation Guide for a complete list of HPM parameters.
    public Map<String, String> getExtraParameters() {
     return new Map<String, String> {
     'field_maxConsecutivePaymentFailures' => '1', 
     'field_maxConsecutivePaymentFailures' => '1', 
     'field_creditCardType' => 'Visa'

See Hosted Payment Pages Fields for a complete list of parameters.