Newer Version Available

This content describes an older version of this product. View Latest

Ensure Refunds Async Input

ID of a credit memo to ensure refunds for, an amount of excess funds to refund, or both. At least one is required. Also includes any invoices for fees that reduce the refund amount, such as return fees. If multiple payment methods are available, you can specify how to distribute the refund.
Root XML tag
<ensureRefundsAsyncInput>
JSON example
1{
2  "creditMemoId": "50gR000000000JB00G",
3  "invoicesToPay": [
4  {
5  .."invoiceId": "3ttR000000000JNIAY"
6  }
7]
8}
Properties
Name Type Description Required or Optional Available Version
creditMemoId String ID of the credit memo that represents a refund amount. Either creditMemoId or excessFunds​Amount is required 48.0
excessFunds​Amount Double Amount of excess funds to refund. Either excessFunds​Amount or creditMemoId is required 49.0
invoicesToPay Invoice To Pay Input[] List of invoices for any fees that reduce the refund, such as return fees. Optional 56.0
isAllowPartial Boolean This value controls the behavior when the amounts included in the sequences list don’t cover the entire refund amount. If this value is false, then the default refund logic is applied to ensure the remaining refund amount. If this value is true, then the unrefunded balance remains on the credit memo. If you don’t specify a sequences list, this value is ignored and the default refund logic is applied. The default value is false. Optional 56.0
isReservedBalanceAmountConsidered Boolean If true, the refundable amount is used to open the payment balance for the reservedBalanceAmount in the Order Payment Summaries. The remaining refundable amount considers the sequence of order payment summaries, if provided. If false, any reserved balance amount for exchanges is refunded. Optional 59.0
sequences Sequence Order Payment Summary Input[] Ordered list of refund amounts and OrderPaymentSummaries to apply them to. An OrderPaymentSummary must either belong to the order summary or be a reference to the order summary in the OrderPaymentSummaryReference entity. The process traverses this list in order and stops when it's refunded the full amount. Optional 56.0