Open invoice modifications

Modification on open invoices can be submitted as normal payment modifications requests. However, there are few considerations that have to be taken into account when performing them.

Capture modifications

When the transaction is authorised, and the goods are sent/delivered to the shopper, a capture modification must be submitted to Adyen. This modification triggers the invoice to be sent to the shopper.

When performing a manual capture:

  • Capture the full amount of the authorised payment.

  • Capture a partial amount of the authorised payment. 

    This functionality requires additional configuration on Adyen's end. To enable it, contact the  Support Team.

It is not possible to do partial captures if there is only one invoice line.

There is no auto-capture for open invoice payments by default. You must manually submit a capture modification. However, Adyen can configure auto capture for open invoice payments for your account. Contact the Adyen Support Team to request this feature.

If you submit a partial capture, please add invoice lines to the additional data of the capture request, so an invoice can be sent to the shopper containing only captured items.

For multiple partial captures, Klarna and AfterPay work slightly different than RatePAY: 

RatePAY: One invoice is created per payment, and the shopper will receive a modified invoice on each capture and refund. 

Klarna and AfterPay: A new invoice is created upon every capture.

For this reason, store the acquirerReference related to the capture as it is required to include the acquirerReference on (partial) refund requests.

The acquirerReference can be included on the standard capture notifications.

Refund modifications

When a refund request is sent in, the open invoice partner will no longer request the shopper to pay the invoice. If the shopper already paid, they will be refunded.

Full refunds do not need additional data. However, if a shopper returns part of the order, it is advised to send a partial refund and add the invoice lines that have been returned.

For Klarna and AfterPay, it is also required to add the acquirerReference of the capture if there are multiple partial captures available for the payment.  When manually doing refunds via Adyen's Customer Area the acquirerReference can be added manually as well.

Cancel modifications

Cancels the payment before money is collected. This needs to be sent pre-capture.

If a payment, or a part of a payment, will not be captured, it is advised to cancel the payment. Any amount not captured will be cancelled at the invoicing partner. This increases authorisation rates, because the invoicing partner will more likely reject authorisation requests for shoppers that have open authorisations (since they can potentially still be captured).

Partial capture example

{
  "merchantAccount" : "MyMerchantAccount",
  "modificationAmount" : {
    "currency" : "EUR",
    "value" : "800"
  },
  "originalReference" : "81234567890123456",
  "additionalData" : {
    "openinvoicedata.line1.currencyCode" : "EUR",
    "openinvoicedata.line1.description" : "Shoes",
    "openinvoicedata.line1.itemAmount" : "661",
    "openinvoicedata.line1.itemVatAmount" : "139",
    "openinvoicedata.line1.itemVatPercentage" : "2100",
    "openinvoicedata.line1.numberOfItems" : "1",
    "openinvoicedata.line1.vatCategory" : "High",
    "openinvoicedata.numberOfLines" : "1"
  }
}
{
  "pspReference" : "8515071322806376",
  "response" : "[capture-received]"
}

Partial refund example

{
  "merchantAccount" : "MyMerchantAccount",
  "modificationAmount" : {
    "currency" : "EUR",
    "value" : "800"
  },
  "originalReference" : "81234567890123456,
  "additionalData" : {
    "acquirerReference" : "1004567890123",
    "openinvoicedata.line1.currencyCode" : "EUR",
    "openinvoicedata.line1.description" : "Shoes",
    "openinvoicedata.line1.itemAmount" : "661",
    "openinvoicedata.line1.itemVatAmount" : "139",
    "openinvoicedata.line1.itemVatPercentage" : "2100",
    "openinvoicedata.line1.numberOfItems" : "1",
    "openinvoicedata.line1.vatCategory" : "High",
    "openinvoicedata.numberOfLines" : "1"
  }
}
{
  "pspReference" : "8515071322806376",
  "response" : "[refund-received]"
}