home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Migrate to CyberSource v2.0

Migrating to the CyberSource v2.0

Learn how to migrate to the CyberSource v2.0 payment gateway by enabling the integration, setting up an instance, updating gateway settings, and deactivating the legacy gateway.

To migrate to the CyberSource v2.0 payment gateway integration, complete the following tasks:

  1. Enable the CyberSource, Payment API v2.0 payment gateway integration. See Enable payment gateway integrations for your tenant .
  2. Set up a CyberSource, Payment API v2.0 instance. See Set up and configure a CyberSource payment gateway instance .
  3. Update the gateway setting on your tenant depending on your business requirements:

    Business requirements

    Instructions

    Set the CyberSource v2.0 instance as the default gateway for all customer accounts on your tenant

    1. Follow the instructions in Set up payment gateways to set the default gateway.

    2. Complete the following steps to check and update the payment gateway setting of customer accounts on your tenant:

      1. In Zuora UI, navigate to Customers > Customer Accounts .

      2. Export customer account data:

        1. On the Accounts page, click the Export icon export customer accounts
          next to the filter section. The Exports page is displayed.

        2. Select CustomerAccounts Zip from the Export Data dropdown list.

        3. Click Export . When the CustomerAccounts.zip file is ready, it is displayed in the list.

        4. Click the file name to download the file.

        5. Decompress the CustomerAccounts.zip file. It contains three files, including CustomerAccount.csv, Contact.csv, and PaymentMethod.csv. You will only need to use CustomerAccount.csv.

      3. Update the CustomerAccount.csv file. For customer accounts that use the default payment gateway, the cell must be empty.

        1. Open the CustomerAccount.csv file.

        2. For customer accounts that will use the new default payment gateway, update the Payment Gateway cell to empty.

        3. Save the file.

      4. Import the updated CustomerAccount.csv file:

        1. Navigate to Customers > Customer Accounts .

        2. Click the Import icon import customer accounts
          .

        3. In the Import window, select Customer Accounts from the Type list, and then click Choose File to browse to and select the updated CustomerAccount.csv file.

        4. Click Import .

    Update the gateway setting of a customer account

    1. Open the customer account page.

    2. Navigate to the Billing and Payment Info section, and click Edit .

    3. In the Payment Gateway field, select the CyberSource v2.0 gateway instance from the list.

    4. At the bottom of the section, click Save .

    Update the gateway setting of hosted payment pages

    1. Navigate to Settings > Payments > Setup Payment Page and Payment Link .

    2. Find your payment page in Page List and click Edit in the Action column.

    3. In the Payment Gateway section, select the CyberSource v2.0 gateway instance from the Default Payment Gateway list.

    4. At the bottom of the page, click Generate and Save Page .

    Update customized integration

    If you have implemented any customized integration by passing in the gateway ID of the legacy gateway instance in your code, replace it with the gateway ID of the CyberSource v2.0 gateway instance.

  4. Deactivate the legacy gateway instance.

Last updated: December 3, 2025