Welcome to Zuora Product Documentation

Explore our rich library of product information

Credit Card Type Payment Pages

This document details the client parameters supported for Credit Card type Payment Pages 2.0, including options for accepted card types, city blacklists and whitelists, and fraud screening.

The following table lists the client parameter specifically supported for the Credit Card type of Payment Pages 2.0.

Parameter

Required?

Description

param_supportedTypes

Optional

This parameter overrides the credit card "Accepted Types" set up for your payment gateway. Supported values are:

  • Visa

  • MasterCard

  • AmericanExpress

  • Discover

  • Dankort

  • JCB

Specify a comma-separated list of values with no space in between, e.g., "AmericanExpress, Visa, MasterCard". Payment Page will display the specified credit card type icons in the order given in the value.

If you do not specify this parameter, the credit card "Accepted Types" displays the following credit card types by default:

  • Visa

  • Mastercard

  • Discover

cityBlackList

Optional

Use this parameter to block end users in blacklisted cities from creating credit card payment methods. If end users specify blacklisted cities in the City field when entering their credit card information, an error message is displayed and the payment method cannot be created.

Note that you can also localize the blacklist cities and error messages.

cityWhiteList

Optional

Use this parameter to always allow end users in whitelisted cities to create credit card payment methods.

Note that you can also localize the whitelisted cities and error messages.

pmId

Optional

Use this parameter to allow end customers to view and enter their existing credit card payment method information, such as the expiration date, CVC code and address information, and re-authenticate the credit card upon submission.

Except for card number and cardholder name, all other credit card fields are available for editing in the Payment Pages 2.0 iFrame form.

If an orphan payment method is associated with a billing account during re-authentication and if checkDuplicated is set to true , Zuora will check the active and closed payment methods associated with the same billing account to ensure that no duplicate payment methods are created.

Payment Pages 2.0 iFrame is PCI compliant. The card information can not be fraudulently edited outside.

This field maps to the refId field in the response.

screeningAmount

Optional

For Chase Paymentech Orbital Gateway integrations, if the Safetech Fraud service is enabled, you can use the screeningAmount field to pass in the amount used for fraud screening for Credit Card validation transactions.

Two-decimal amount is supported.

If screeningAmount is not specified, the authorization amount is used for fraud screening.