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

Define and set up payment methods

Duplication check on payment methods

Learn how Zuora checks for duplicate payment methods to prevent duplication when creating or updating payment methods.

When creating or updating the following types of payment methods, if fields required for duplication check are passed in, Zuora will check the active and closed payment methods associated with the same billing account to ensure that no duplicate payment methods are created. To enable this duplication check support, submit a request at Zuora Global Support .

Payment method

Fields used for duplication check

Credit Card

cardNumber

ACH

  • routing number (passed through the bankABACode field)

  • bankAccountNumber

Bank Transfer

Autogiro - Direct Debit SE

  • accountNumber

  • branchCode

Bacs - Direct Debit UK

  • accountNumber

  • bankCode

Becs - Direct Entry AU

  • accountNumber

  • branchCode

Becsnz - Direct Debit NZ

  • accountNumber

  • bankCode

  • branchCode

Betalingsservice - Direct Debit DK

  • accountNumber

  • bankCode

SEPA - Single Euro Payments Area

IBAN

PAD - Pre-Authorized Debit

  • accountNumber

  • bankCode

  • branchCode

The duplication check is supported in the following approaches to creating or updating payment methods. In addition to the fields listed in the preceding table, ensure the following fields are passed in. Otherwise, the duplication check will not be performed.

Approach

Required fields to perform duplication check

Hosted payment page

  • iFrame

  • Direct Post

  • field_accountId client parameter

  • checkDuplicated client parameter = true

  • Create a payment method API operation

  • Update a payment method API operation

  • accountKey

  • processingOptions.checkDuplicated = true

Create an account API operation

  • accountKey

  • paymentMethod.processingOptions.checkDuplicated = true

  • Create an order API operation

  • Create an order asynchronously API operation

  • Update an order API operation

  • accountKey

  • newAccount.paymentMethod.processingOptions.checkDuplicated = true

If the payment method is duplicated, the following error message is returned:

The account number already exists with payment method Id <Payment_Method_ID>, please use a new account number or delete the existing one.

When creating the Credit Card payment method through the API operation, you can also use the checkDuplicated field at the top level of the payment method object to indicate whether to perform the duplication check. However, this field is being deprecated and the nested checkDuplicated field listed in the preceding table takes precedence.

Last updated: December 3, 2025