This article describes the configuration fields specific to Chase Paymentech Orbital Gateway, API v7.0.1. For complete information about enabling, configuring, and testing an Orbital gateway instance, see Set up and configure a Chase Orbital payment gateway instance.
Additional configuration fields
In addition to common configuration fields, you also have to configure the additional fields that are available for Orbital 7.0.1.
- Enable Level 2 Card Data
Level 2 Card Data provide customers and merchants with additional information on their credit card statements about their purchases such as the amount of sales tax they pay and to reconcile transactions with a unique customer code.
- Enable Level 3 Card Data
Enabling 3 Card Data means additional order and line item is passed to Orbital when processing a credit card transaction. This information may result in lower interchange rates on eligible commercial, corporate and purchasing cards. This functionality must also be enabled for your Chase Orbital account.
- Commodity Code
Commodity codes are used in Level 3 data by accounts payable and procurement software to classify the goods purchased. There is no universally accepted commodity code standard, but the United Nations Standard Products and Services Code (UNSPSC) is widely deployed. An example of the UNSPSC Commodity Code for Software is 43230000. Orbital accepts a maximum of 12 characters. This field is required if you have enabled Level 3 Card Data
- Enable Safetech Fraud Service
Safetech Fraud Service is enabled through the Chase Pay Orbital portal. When enabled, additional order information and customer parameters are passed to the Safetech Fraud Management tool for evaluation using Zuora's API or Hosted Payment Page. This is only supported for validation (authorization) transactions but not yet for payment transactions.
- Safetech Merchant ID
- Safetech Fraud Score Indicator
- Enable gateway reconciliation
See Gateway Reconciliation for more information.
- Reconciliation Username
SFTP username for Reconciliation.
- Reconciliation Password
SFTP password for Reconciliation. This password expires every three months. Therefore, you need to reset the password every three months on the Orbital side and in Zuora configuration.
Zuora recommends you to enable the Gateway Reconciliation Job Completion | Reconciliation Completed Notification. With this notification turned on, you will get notified if the Gateway Reconciliation job fails because you forgot to reset the password or for any other reason. See Notifications for more information.
- Enable AVS field length validation
This option is only available in Orbital 6.4.4 and Orbital 7.0.1, and it is not selected by default. If you select this check box, Zuora will truncate the value of the following AVS request fields based on the field length limitations of the Orbital gateway:
AVS Fields Field Length Limitation AVSname 30 characters AVSaddress1 30 characters AVSaddress2 30 characters AVScity 20 characters AVSphoneNum 14 characters AVSzip 10 characters
Note that the acceptable characters are alphanumeric characters, including 0~9, a~z, and A~Z. Special characters like
äwill be considered as 2 characters. Hence, if special characters are used in the AVS validation fields, you might get a length validation error.
Orbital Gateway Reconciliation Prerequisites
Gateway reconciliation for Orbital version 7.0.1 is enabled through the Chase Orbital portal.
- Contact Orbital to get access to the Orbital Virtual Terminal Scheduled Reporting.
- Enable Closed Batch Detail Report and Rejected Batch Detail Report.
- Request a Batch User ID and the password.
- Set Report type to File/CSV.
- Set Delivery method to SFTP.
Reconciliation reports are scheduled to run daily at 23:00:00 PDT. Zuora automatically retrieves the reports and they can be viewed by accessing Payment Operations > Gateway Reconciliation.