Welcome to Zuora Product Documentation

Explore our rich library of product information

Unapply payments

This reference document lists all fields in the Payments data dictionary.

.

Note: Fields with an asterisk mark indicate mandatory fields.
ObjectField NameValueRequired to UpdateDescription
PaymentIsNewPaymentTRUE or FALSEThis field is required when unapplying a payment to a Debit Memo or Invoice. Enter "True" if applicable; otherwise, set the value to "False" or leave the cell blank.Indicator Column marking the start of a new object
PaymentEffective DateSTRING <date>OptionalThe date when the payment is unapplied, in yyyy-mm-dd format. The effective date must be later than or equal to the maximum effective date of the payment.
PaymentpaymentKey *STRINGRequired for updating payment recordThe unique ID or number of an unapplied payment. For example, 8a8082e65b27f6c3015b89e4344c16b1, or P-00000001.
Array of objects (debitMemos)IsNewDebitMemoTRUE or FALSEThis field is required when unapplying a payment to a Debit Memo. Enter "True" if applicable; otherwise, set the value to "False" or leave the cell blank.Indicator Column marking the start of a new object
Debit MemoDebit Memo Amount*number <double>Required when unapplying payment to Debit MemoThe amount of the payment that is unapplied from the debit memo.
Debit MemoDebit Memo IdSTRINGThe unique ID of the debit memo that the payment is unapplied from.
Debit MemoDebit Memo NumberSTRINGThe number of the debit memo that the payment is unapplied from.
Array of objects (items)IsNewDebitMemoItemTRUE or FALSEThis field is required when unapplying a payment to a Debit Memo Items. Enter "True" if applicable; otherwise, set the value to "False" or leave the cell blank.Indicator Column marking the start of a new object
Debit Memo ItemsDebit Memo Items Amount*number <double>Required when unapplying payment to Debit Memo ItemThe amount of the payment that is unapplied from the specific debit mem or taxation item.
Debit Memo ItemsDebit Memo Items Debit Memo Item IdSTRINGThe ID of the specific debit memo item.
Debit Memo ItemsDebit Memo Items Tax Item IdSTRINGThe ID of the specific taxation item.
Array of objects (invoices)IsNewInvoiceTRUE or FALSEThis field is required when unapplying a payment to an Invoice. Enter "True" if applicable; otherwise, set the value to "False" or leave the cell blank.Indicator Column marking the start of a new object
InvoiceInvoice Amount*number <double>Required when unapplying payment to InvoiceThe amount of the payment that is unapplied from the invoice.
InvoiceInvoice IdSTRINGWhen both the invoiceNumber and invoiceId fields are specified, the two fields must match with each other.The unique ID of the invoice that the payment is unapplied from.
InvoiceInvoice NumberSTRINGWhen both the invoiceNumber and invoiceId fields are specified, the two fields must match with each other.The number of the invoice that the payment is unapplied from. For example, INV00000001.
Array of objects (items)IsNewInvoiceItemTRUE or FALSEThis field is required when unapplying a payment to Invoice Items. Enter "True" if applicable; otherwise, set the value to "False" or leave the cell blank.Indicator Column marking the start of a new object
Invoice ItemsInvoice Items Amount*number <double>Required when unapplying payment to Invoice ItemsThe amount of the payment that is unapplied from the specific invoice or taxation item.
Invoice ItemsInvoice Items Invoice Item IdSTRINGThe ID of the specific invoice item.
Invoice ItemsInvoice Items Tax Item IdSTRINGThe ID of the specific taxation item.