Switch payment gateways
Learn how to switch from your current payment gateway to a new one in Zuora, ensuring all prerequisites and refund processes are handled correctly.
If you currently have a payment gateway for processing transactions in Zuora but want to switch to another new gateway, follow the instructions in this article. In the following sections, the current gateway is referred to as gateway A and the new gateway is referred to as gateway B.
Prerequisites
-
Verify whether gateway B is supported by Zuora’s payment gateway integration service. See Supported payment gateways for more information.
-
Verify whether payment methods, payment operations, and payment processing features that you want are supported by gateway B. See the Overview article for gateway B.
-
Before deactivating gateway A and switching to gateway B, use one of the following approaches to handle possible refunds for existing payments. If gateway A is deactivated, the referenced refunds cannot be processed successfully and an error will return. If the account and payment method data on gateway A have been migrated to your new merchant account on gateway B, the refund will fail on gateway A even though it is still active. In this case, you must use the option 2.
-
Keep gateway A active and continue using it to process referenced refunds for the existing payments.
-
If gateway B supports non-referenced refunds, create non-referenced refunds with gateway B for the existing payments that were processed through gateway A. You can find whether gateway B supports non-referenced refunds in the Overview article of gateway B.
-
Related information
-
Select and sign up for a payment gateway
-
Set up payment gateways
-
Using multiple payment gateways
-
Test payment gateways
-
Going live with your payment gateways
-
Disable payment gateway integrations