Capture-only Payments with External Authorization

Use capture-only payments when your checkout authorizes a payment directly with Adyen and instellix should capture that existing authorization during the order-to-cash process. In this setup, you create a Payment Authorization in instellix with the Adyen pspReference and the Order or Contract it belongs to. When the Payment Intent is created, instellix captures against that authorization instead of performing a new one.

When to use this setup

Use capture-only payments when:

Your checkout handles the customer interaction and payment authorization.
Adyen returns a pspReference for the successful authorization.
instellix creates the invoice and performs the capture later.

Use the standard authorize-and-capture flow when instellix should perform both steps.

How it works

Your checkout authorizes the payment with Adyen.
Adyen returns the pspReference.
Your integration creates a Payment Authorization in instellix with that reference and the Order or Contract it belongs to.
When the Payment Intent is created, instellix looks up the Payment Authorization for that Order or Contract.
instellix sends a capture request to Adyen using the stored authorization reference.

If several Payment Authorizations exist for the same Order, instellix uses the most recently created one.

The external system remains responsible for creating a valid authorization and providing its reference before capture. instellix does not perform an additional authorization in PRE_AUTHORIZED mode.

Configure Adyen for capture-only payments

Go to: Integration > Payment Providers > Adyen

Add or edit the Adyen configuration used for the capture.
Set Authorization mode to Pre-authorized.
Save the configuration.

The following authorization modes are available:

Authorization mode	Behavior
`PRE_AUTHORIZED`	Captures an existing Adyen authorization using its `pspReference`.
`AUTHORIZE_THEN_CAPTURE`	Performs a new authorization and capture. This is the default.

If no matching Payment Authorization is available in PRE_AUTHORIZED mode, the Payment Intent changes to FAILED. instellix does not fall back to a new authorization.

Create the Payment Authorization

Creating a Payment Authorization is required. Without it, instellix has no reference to capture against and the Payment Intent fails.
POST /v2/merchant-payment-accounts/{merchantPaymentAccountIdent}/payment-authorizations

{
  "authorizationReference": "8836184345001234",
  "reference": {
    "type": "ORDER",
    "ident": "order-123"
  },
  "amount": {
    "amount": 23.56,
    "currency": "EUR"
  }
}

Field	Description
`authorizationReference`	The authorization reference from the payment service provider, for example the Adyen `pspReference`.
`reference.type`	`ORDER` or `CONTRACT`.
`reference.ident`	Ident of the referenced Order or Contract.
`amount`	Authorized amount and currency.

Order requirements

The Order still follows the standard charging setup:

paymentInformation.paymentControl is set to CHARGE.
A Customer Payment Account is assigned to the Order.

View Payment Authorizations

Go to: Payments > Payment Authorizations

The overview shows:

Authorization reference
Referenced Order or Contract
Amount and currency
Merchant Payment Account

You can filter by authorization reference and open the referenced Order or Contract directly.

Payment Authorizations can also be queried across the tenant:

GET /v2/payment-authorizations

The endpoint supports RSQL filtering, pagination, and sorting.