Change the authorised amount

post/adjustAuthorisation

API Version

Allows you to increase or decrease the authorised amount after the initial authorisation has taken place. This functionality enables for example tipping, improving the chances your authorisation will be valid, or charging the shopper when they have already left the merchant premises.

This endpoint is part of our classic API integration. If you have a newer integration, and are doing:

Asynchronous adjustments, use the /payments/{paymentPspReference}/amountUpdates endpoint on Checkout API.

Synchronous adjustments, use this endpoint.

Endpoint destination URL

https://pal-test.adyen.com/pal/servlet/Payment/v68/adjustAuthorisation

Request Parameters

Required

Optional

This field contains additional data, which may be required for a particular modification request.

The additionalData object consists of entries, each of which includes the key and value.

The merchant account that is used to process the payment.

The amount that needs to be adjusted. The currency must match the currency used in authorisation, the value must be smaller than or equal to the authorised amount.

Authentication data produced by an MPI (Mastercard SecureCode, Visa Secure, or Cartes Bancaires).

The original merchant reference to cancel.

The original pspReference of the payment to modify. This reference is returned in:

authorisation response
authorisation notification

Defines how to book chargebacks when using Adyen for Platforms.

Your reference for the payment modification. This reference is visible in Customer Area and in reports. Maximum length: 80 characters.

An array of objects specifying how the amount should be split between accounts when using Adyen for Platforms. For more information, see how to split payments for platforms.

The unique identifier of the account to which the split amount is booked. Required if type is MarketPlace or BalanceAccount.

Classic Platforms integration: The accountCode of the account to which the split amount is booked.
Balance Platform: The balanceAccountId of the account to which the split amount is booked.

The amount of the split item.

Required for all split types in the Classic Platforms integration.
Required if type is BalanceAccount, Commission, Default, or VAT in your Balance Platform integration.

Your description for the split item.

Your unique reference for the part of the payment booked to the specified account.

This is required if type is MarketPlace (Classic Platforms integration) or BalanceAccount (Balance Platform).

For the other types, we also recommend providing a unique reference so you can reconcile the split and the associated payment in the transaction overview and in the reports.

The part of the payment you want to book to the specified account.

Possible values for the Balance Platform:

BalanceAccount: books part of the payment (specified in amount) to the specified account.
Transaction fees types that you can book to the specified account:
- AcquiringFees: the aggregated amount of the interchange and scheme fees.
- PaymentFee: the aggregated amount of all transaction fees.
- AdyenFees: the aggregated amount of Adyen's commission and markup fees.
- AdyenCommission: the transaction fees due to Adyen under blended rates.
- AdyenMarkup: the transaction fees due to Adyen under Interchange ++ pricing.
- Interchange: the fees paid to the issuer for each payment made with the card network.
- SchemeFee: the fees paid to the card scheme for using their network.
Commission: your platform's commission on the payment (specified in amount), booked to your liable balance account.
Remainder: the amount left over after a currency conversion, booked to the specified account.
TopUp: allows you and your users to top up balance accounts using direct debit, card payments, or other payment methods.
VAT: the value-added tax charged on the payment, booked to your platforms liable balance account.
Commission: your platform's commission (specified in amount) on the payment, booked to your liable balance account.
Default: in very specific use cases, allows you to book the specified amount to the specified account. For more information, contact Adyen support.

Possible values for the Classic Platforms integration: Commission, Default, MarketPlace, PaymentFee, VAT.

The transaction reference provided by the PED. For point-of-sale integrations only.

Unique terminal ID for the PED that originally processed the request. For point-of-sale integrations only.

Response parameters

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

200 - OK
The request has succeeded.
additionalDataobject
This field contains additional data, which may be returned in a particular modification response.
pspReferencestring
Adyen's 16-character string reference associated with the transaction/request. This value is globally unique; quote it when communicating with us about this request.
responsestring
Indicates if the modification request has been received for processing.
400 - Bad Request
A problem reading or understanding the request.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.
401 - Unauthorized
Authentication required.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.
403 - Forbidden
Insufficient permissions to process the request.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.
422 - Unprocessable Entity
A request validation error.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.
500 - Internal Server Error
The server could not process the request.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.

Change the authorised amount

HTTP Responses

200 - OK

400 - Bad Request

401 - Unauthorized

403 - Forbidden

422 - Unprocessable Entity

500 - Internal Server Error