Welcome to Zuora Product Documentation

Explore our rich library of product information

Sync payment info

This reference lists payment fields and visibility rules for payments synchronized between Zuora and an enterprise resource planning (ERP) system.

Payment visibility

The following rules determine whether payments are shown in the Cash application interface:

  • Payments created in Cash application are always shown.
  • Payments posted from Cash application and not modified in the ERP are always shown.
  • Payments posted from Cash application and modified in the ERP are not shown by default. Configure the payment visibility settings to show these payments in Cash application.
  • Payments created in the ERP are not shown by default. Configure the payment visibility settings to show these payments in Cash application.
Note:

To show payments that are posted from Cash application and modified in the ERP or created in the ERP, configure both payment categories together. Do not configure either category separately.

Fields used to identify modified payments

When Zuora retrieves a payment from the ERP, it evaluates the following fields according to the comparison rules in the table:

Field Comparison
sourceCustomerId Not applicable
accountSourceId Not applicable
amount Always compared
paymentDate Configurable comparison, not enabled by default
modeId Never compared
description Never compared
appliedAmount / unAppliedAmount Configurable comparison, not enabled by default

A change to the amount applied to an invoice does not classify the payment as modified by default. If comparison of appliedAmount or unAppliedAmount is configured, the change can qualify the payment as modified.

appliedInvoiceList Always compared

Any change to the invoice list qualifies the payment as modified. This comparison uses the invoices associated with the payment, not the amount applied to the payment.