After setting up the Checkout pages for your site, you can use additional features to customize how you use Checkout pages.
You can pre-populate the input or hidden fields on a hosted page with the values that are passed in as parameters. To pre-populate a field, append the parameter to the URL in the format
For example, to select Visa by default:
You use this method to pre-populate any field with values. A full list of the of the input fields can be found in Checkout page fields.
You can pre-load a hosted page with up to five passthrough parameters. The parameters will be appended in the callback. This is useful for merchants who would like to have specific pieces of information returned to the callback path, e.g. internal confirmation numbers, version test codes, etc. The passthrough parameters are:
The passed in fields are sent back to the callback URL using the same name.
For example, for a request like the following:
The callback would look like the following:
The credit cards logos shown on your Checkout pages are configured when you set up your payment gateway in the Zuora application. However, the merchant has the ability to dynamically overwrite the credit card "Accepted Types" configuration by passing in a comma-separated value into the hosted page. If a value has been passed in, the configuration will be ignored. If a value has not been passed in, the configured values will be shown on the iFrame.
For example, if your gateway is configured to accept Visa, MasterCard, and Amex but you want to only show Visa and Mastercard on your iFrame, you can pass in the following to the iFrame URL:
Gateway Options is a feature that allows merchants to pass additional parameters to the payment gateway that currently are not supported by the Checkout pages. This is particularly useful for merchants who want to do customized reporting with payment gateways that support the Gateway Options feature, such as CyberSource and Verifi.
The merchant has the option to submit information to the payment gateway associated with the hosted page. The hosted page can take key/value pairs to be sent as part of the gateway options when the payment method is created. Use the format
param_gwOptions_[Key]=[Value] to append the key/value pairs.
For example, if you wanted to pass in the IP address option:
globalIPaddress = someaddress123
Then you owuld append the following to the iFrame URL:
The URL with the above Gateway Option would be:
The Gateway Options feature is not supported by all gateways integrated with Zuora.
The following gateways support Gateway Options:
The following gateways do not support Gateway Options: