Required Configuration Fields By Gateway
You can set up Z-Payments to use one preferred payment gateway. Because each gateway has different requirements, the setup page for each of these payment gateways varies. Contact your payment gateway to obtain the information required to configure the gateway in Zuora.
List of Available Fields
The following fields are available for the Authorize.net, Chase Orbital, CyberSource, and Ingenico ePayments payment gateways.
Standard Fields
All payment gateways configurations in Zuora use the following fields:
- Name
- Use Gateway Test Environment
- Credit Cards Accepted
- Default Authorization Amount
- Verify new payment method (optional)
- Verify updated payment method (optional)
Authorize.net Fields
The Authorize.net gateway uses the following fields:
- API Login ID
- Transaction Key
CyberSource Fields
The CyberSource gateway uses the following fields:
- Merchant ID
- Private Key
The private key is a security file that must be downloaded within your CyberSource Business Center. To download the security (.p12) file from the Business Center, go to the Account Management tab and select the Transaction Security Keys option. Next follow the instructions on the Transaction Security Keys page in order to generate your security keys for the simple order API. - Use Export Compliance (optional)
CyberSource offers a variety of verification and compliance services, one of which is called Export Compliance. Export Compliance helps online merchants maintain compliance with the U.S. Government export regulations. Visit CyberSource's website to read about the features of Export Compliance. If you have signed up for CyberSource's Export Compliance verification services, you should select the "Use Export Compliance" field in the gateway configuration. By doing this, Zuora will submit an API call (through CyberSource) to verify whether the end customer (credit card holder) is on a black list of countries or person with whom the merchant should not accept orders from. If the export compliance verification fails, the payment method verification also fails which may result in the order not being accepted (for example, the subscribe call will fail).
Ingenico ePayments Collect Fields
The Ingenico ePayments gateway uses the following fields:
- Merchant ID
- Soft Descriptor
Vantiv Fields
The Vantiv gateway (formerly called Litle) uses the following fields:
- Merchant ID
- User Name/ID
- Password
Merchant e-Solutions Fields
The Merchant e-Solutions gateway uses the following fields:
- Profile ID
- Profile Key
- IP Address
- Moto eCommerce Indicator
PayPal Payflow Pro
If you are using the PayPal Payflow Pro product, the credentials to configure the gateway in Zuora will be the same as your login credentials for PayPal Manager. If you are using the PayPal Website Payments Pro product, you should request Payflow Pro API credentials and configure those credentials in Zuora.
The PayPal Payflow Pro gateway uses the following fields:
- Partner
The partner is typically PayPal, but may also be Verisign depending on your specific PayPal account set up. - Merchant ID
If you are using the Payflow Pro product, enter your Merchant ID. If you are using Website Payments Pro product, enter your Vendor information here. - User ID
User ID may also be referred to by PayPal as User and may be the same as your merchant login. - Password
- Support Recurring
If you accept credit card reference transaction payment methods, you may consider enabling the Support Recurring option. If Support Recurring is selected, Zuora will mark such payments as recurring when submitting the sale payment transactions to PayPal. For recurring payments, additional security checks for previously authorized transactions may be disabled by PayPal, allowing for reduced fees and greater acceptance with your merchant bank. Please check with PayPal to verify that this is available and appropriate for your account.
SoftBank Fields
The SoftBank Payment Service gateway uses the following fields:
- Merchant ID
- Service ID
- Hashkey
- Basic Authorization Id
- Basic Authorization Password
WorldPay Fields
This feature is in Limited Availability. We are actively soliciting feedback from a small set of early adopters before releasing as generally available.
The WorldPay gateway uses the following fields:
- Merchant code
- User Name
- XML Password