Skip to main content

Zuora Connection Settings

Zuora

Zuora Connection Settings

Configure your organization's Zuora API connection settings

To establish the API connection to Zuora, you must configure the Zuora Connection Settings to authorize Zuora SOAP API for your Salesforce organization.

The Zuora Quotes Connection Settings are at the global level of your organization. If you have the Multi-entity enabled, all the Zuora entities in your org share the same user name and password. When you test the connection, you receive the connection status for each entity.

To configure Zuora connection settings:

  1. In Zuora Quotes, click the Zuora Config tab.
  2. On the Zuora Quotes Configuration Settings page, click Zuora Connection Settings.
  3. Click Edit Settings.
  4. Enter information for the configuration fields. The values that you enter in these fields depend on your Zuora and Salesforce configuration. The table below describes these fields in more detail.
    Note: If you do not have an API User Name and API Password, you must create one.
  5. Click Test Connection to verify the new connection setting to Zuora.
  6. Click Save.

The following fields are available to set up a connection to Zuora.

Field Description Required? Legacy CPQ CPQ X
SOAP API URL

Specify the URL provided by Zuora, including the WSDL version that you want to use. This will typically be in the format:

<Zuora Domain URL>/apps/services/a/<version>

<Zuora Domain URL> depends on the Zuora environment:

  • US Cloud 1 Production - https://na.zuora.com
  • US Cloud 1 API Sandbox - https://sandbox.na.zuora.com
  • US Cloud 2 Production - https://www.zuora.com
  • US Cloud 2 API Sandbox - https://apisandbox.zuora.com
  • US Central Sandbox - https://test.zuora.com
  • Production Copyhttps://servicesNNN.zuora.com
  • Performance Testhttps://pt1-api.zuora.com
  • EU Productionhttps://eu.zuora.com
  • EU API Sandboxhttps://sandbox.eu.zuora.com
  • EU Central & Developer Sandbox - https://test.eu.zuora.com
  • APAC Production https://ap.zuora.com
  • APAC Central & Developer Sandbox -https://test.ap.zuora.com

The latest WSDL version can be found in the latest Zuora Release Notes, or in the downloaded WSDL file by navigating to Billing Settings > Download the Zuora WSDL in your Zuora tenant.

For example: 

  • https://www.zuora.com/apps/services/a/80.0
  • https://apisandbox.zuora.com/apps/services/a/80.0
  • https://test.ap.zuora.com/apps/services/a/80.0
Yes File:Z_Media/checkmarkGreen_xsm.png File:Z_Media/checkmarkGreen_xsm.png
REST API URL

The REST API URL is automatically generated based on the SOAP API URL field. For example, if you specified https://apisandbox.zuora.com/apps/services/a/80.0 as the SOAP API URL, the generated REST API URL is https://rest.apisandbox.zuora.com.

The following list provides all supported REST API URLs:

  • US Cloud 1 Production - https://rest.na.zuora.com
  • US Cloud 1 API Sandbox - https://rest.sandbox.na.zuora.com
  • US Cloud 2 Production - https://rest.zuora.com
  • US Cloud 2 API Sandbox - https://rest.apisandbox.zuora.com
  • US Performance Test  - https://rest.pt1.zuora.com
  • US Central & Developer Sandboxhttps://rest.test.zuora.com
  • US Production Copy -  Submit a request at Zuora Global Support to enable the Zuora REST API in your tenant and obtain the base URL for REST endpoints. See REST endpoint base URL of Production Copy (Service) Environment for existing and new customers for more information.
  • EU Productionhttps://rest.eu.zuora.com
  • EU API Sandboxhttps://rest.sandbox.eu.zuora.com
  • EU Central & Developer Sandbox - https://rest.test.eu.zuora.com
  • APAC Production https://rest.ap.zuora.com
  • APAC Central & Developer Sandbox -https://rest.test.ap.zuora.com
Yes File:Z_Media/checkmarkGreen_xsm.png File:Z_Media/checkmarkGreen_xsm.png
API User Name

Use the user name provided by Zuora. 

Zuora recommends that you use an API user for the connection setting so that the password does not expire. However, you can use either a UI or an API user to successfully establish a connection.

Yes File:Z_Media/checkmarkGreen_xsm.png File:Z_Media/checkmarkGreen_xsm.png
API Password Use the password provided by Zuora. Yes File:Z_Media/checkmarkGreen_xsm.png File:Z_Media/checkmarkGreen_xsm.png

If you plan to use flexible billing, you must use OAuth, for which API client ID and API client secret are mandatory to enter in your Zuora connections. For information about flexible billing features in CPQ X, see Enable and use Flexible Billing Attributes.

Field Description Required? Legacy CPQ CPQ X
API Client Id

When you create an OAuth client for a user, Zuora displays the information for these fields. For more information about how to generate the authentication credentials, see Create OAuth client for user.

Yes   File:Z_Media/checkmarkGreen_xsm.png
API Client Secret Yes   File:Z_Media/checkmarkGreen_xsm.png

Authorize the additional Zuora REST API

If you have installed Zuora Quotes 9.22+ or CPQ X is enabled in your organization, the Zuora REST API is automatically authorized. For a full list of REST API URLs, see Access to the URL.

However, if you upgrade Zuora Quotes from an version ealier than 9.22 to version 9.22+, you must manually authorize Zuora REST API. Otherwise, a warning will be reported when you click Test Connection to verify the connection setting to Zuora.

To authorize Zuora REST API:

  1. In Zuora Quotes, click the Zuora Config tab.
  2. On the Zuora Quotes Configuration Settings page, click Zuora Connection Settings.
  3. Click Edit Settings.
  4. Click Test Connection (You may need to authorize the Remote Site of Zuora REST API with the steps below.).
  5. Click Save.

To authorize the Remote Site of Zuora REST API:

  1. Navigate to Setup > Administrater > Security Controls > Remote Site Settings.
  2. Click Edit on the left of Zuora_Rest (Production) or Zuora_ApiSandbox_REST_API_Endpoint (Sandbox) on the All Remote Sites page.
  3. Tick the Active checkbox.
  4. Click Save.