Skip to main content

Additional configuration fields for Chase Orbital v7.0.1


Additional configuration fields for Chase Orbital v7.0.1

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.

  1. Contact Orbital to get access to the Orbital Virtual Terminal Scheduled Reporting.
  2. Enable Closed Batch Detail Report and Rejected Batch Detail Report.
  3. Request a Batch User ID and the password.
  4. Set Report type to File/CSV.
  5. 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.