Set up and configure a GoCardless gateway instance

Common configuration fields

There are some common fields you must complete for every gateway configuration. We recommend reviewing Setting Up Payment Gateways for information on these fields: 

• Type
• Name
• Use Gateway Test Environment
• Default Authorization Amount
• Verify new payment method (required)
• Verify updated payment method (optional)

Specific configuration fields

In addition to the common fields, complete the following settings:

• OAuth Token: Select the created OAuth 2.0 token from the OAuth Token dropdown list. You can navigate to Payments Settings > Gateway Authentication to create a new token or view all available tokens. For more information about how to create OAuth tokens in Zuora, see Payment Gateway Authentication.

  One merchant account can have only one active OAuth token. The previous token is automatically expired on the GoCardless end when the new token is created. If a separate token is required because multiple environments are used, please contact GoCardless for a separate testing MID.

• Access Token (read-only): Only available for the gateway instances created before Zuora Billing Release 289. 
• Creditor ID (read-only): Only available for the gateway instances created before Zuora Billing Release 289. 
• (Optional) Enable Batch Gateway Reconciliation (Legacy): Select this check box if you want to enable Gateway Reconciliation batch jobs for GoCardless. See Gateway Reconciliation for more information.
• Verification Preference: This field takes effect only if Zuora’s support for GoCardless Verified Mandates and Instant Bank Pay payment flow is evoked. See Implement Payment Pages 2.0 to support one-time payment flows for how to invoke the payment flow. You can use this field to set the preferred verification level for your mandate by selecting any of the following values from the drop-down list. The default value is recommended. For more information about verification levels that are defined by GoCardless, see GoCardless’ documentation.
  • minimum
  • recommended
  • when_available
  • always

Note that for the GoCardless gateway instances created before Zuora Billing Release 289, the previously stored Access Token and Creditor ID credentials can continue to work, but you cannot update them anymore. If you want to switch to the OAuth authentication mode, you can create an OAuth token and select it from the OAuth Token dropdown list. The OAuth 2.0 authentication is then enabled for all subsequent requests.