Skip to main content

Chase Orbital Version 7.0.1 Integration


Chase Orbital Version 7.0.1 Integration

The upgrade to Orbital 7.0.1 gives you the ability to process credit cards, ACH, SEPA, UK Direct Debit and credit card reference transactions. 

For complete information about enabling, configuring, and testing an Orbital gateway, see Chase Orbital Gateway.

Set up Safetech

See Set up Safetech for details.

Additional Orbital 7.0.1 Configuration Fields

In addition to common configuration fields, you also have to configure the additional fields that are available in 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.

Contact Zuora Global Support to enable Level 3 Card Data for your tenant. To use this feature Level 3 Card Data must also be enabled for your Chase merchant 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.

Credit Card Reference Transactions

Complete the following prerequisites for credit card reference transactions:

  • Enable the credit card reference transaction method of payment. To complete this action, click your username at the top right, navigate to Settings > Payments > Payment Method, click Edit, and select CC Reference Transaction.
  • Contact Zuora Global Support to enable the Payment Tokenization feature for your tenant.

Zuora supports Orbital tokens. Tokens are used for credit card reference transactions in Zuora. A reference transaction is simply a representation of a credit card payment method without having sensitive payment method information like the credit card number stored in Zuora. Please note that the token cannot be used with another gateway, which is why we recommend storing credit card information in Zuora whenever possible.

Currently, only existing Chase Orbital Payment Gateway tokens are supported as a Credit Card Reference Transaction payment method type. Creating tokens in Zuora is not supported.

See the following topics for more information about setting up credit card reference transactions in Zuora.

The following SOAP API call can be used to create a payment method that represents an Orbital-stored credit card.

Request example:

  <ns1:zObjects xsi:type="ns2:PaymentMethod">

Response example:



Currently, refund reconciliation is not supported by Zuora's implementation with the Chase Orbital gateway.