Search docs

Are you looking for test card numbers?

Would you like to contact support?

Start searching Adyen's documentation...

  Documentation

NotificationRequestItem

A container object for the details referring to a single transaction.

Field Type Required Description
additionalData Object -x-

The additionalData object is a generic container that can hold extra fields.

For more information, refer to NotificationRequestItem.additionalData .

amount Amount -white_check_mark-

A container object for the payable amount information for the transaction.

For HTTP POST notifications, currency and value are returned as URL parameters.

pspReference

String

-white_check_mark-

Adyen's 16-character unique reference associated with the transaction/the request. This value is globally unique; quote it when communicating with us about this request.

In REPORT_AVAILABLE response you receive a file name in this field.

In PAIDOUT_REVERSED event code pspsreference is for Capture's pspsreference.

eventCode String -white_check_mark-

The type of event the notification item refers to.

When eventCode returns AUTHORISATION, it does not necessarily mean that the payment authorisation request has been successfully processed. The authorisation is successful if successtrue. If success = false, check the  the reason value for further information on the authorisation failure cause. This can occur, for example, if an error occurs or if the transaction is refused.
eventDate String -white_check_mark-

The time when the event was generated.

  • Format: ISO 8601 ; YYYY-MM-DDThh:mm:ssTZD
  • Example: 2017-07-17T13:42:40+01:00
merchantAccountCode

String

-white_check_mark- The merchant account identifier used in the transaction the notification item refers to.
operations List -white_check_mark-

This field holds a list of the modification operations supported by the transaction the notification item refers to.

The available operations in the list give information on the follow-up actions concerning the payment.
You may be requested to:

  • Capture the payment (for example, if auto-capture is not set up),
  • Cancel the payment (if the payment has not been captured yet), or
  • Refund the payment (if the payment has already been captured).

Possible values:

  • CANCEL
  • CAPTURE
  • REFUND

This field is populated only in authorisation notifications .

In case of HTTP POST notifications, the operation list is a sequence of comma-separated string values.

merchantReference

String

-white_check_mark-

A reference to uniquely identify the payment.
This reference is used in all communication with you about the payment status.
We recommend using a unique value per payment; however, it is not a requirement. If you need to provide multiple references for a transaction, you can enter them in this field.
Separate each reference value with a hyphen character ("-"). This field has a length restriction: you can enter max. 80 characters.

By default, merchantReference is always returned with payment notifications ,
as merchantReference returns the reference field value of the corresponding payment request.
In this case, returned by default = white_check_mark

Modification requests do not require sending a merchant reference value along with the call.
Therefore, the corresponding notifications do not include it by default.
In this case, returned by default = -x-

An empty merchantReference field in a notification message takes null as a value.

originalReference String -x-

If the notification item is about a payment authorisation, this field is not populated and is blank.

If the notification item is about a modification, the originalReference value corresponds to the PaymentRequest value assigned to the original payment.

paymentMethod String -white_check_mark-

The payment method used in the transaction the notification item refers to.

Example payment methods that can be set to this field:

visa , mc , ideal , elv , wallie , and so on.

This field is populated only in authorisation notifications .
reason

String

-x-

This field is included only in some notifications.

This field holds plain text. For more information, refer to the reason field values below.

success String -white_check_mark-

Informs about the outcome of the event ( eventCode ) the notification refers to:

  • true : the event ( eventCode ) the notification refers to was executed successfully.
  • false : the event was not executed successfully.

When eventCode returns AUTHORISATION, it does not necessarily mean that the payment authorisation request has been successfully processed. The authorisation is successful if successtrue. If success = false, check the  the reason value for further information on the authorisation failure cause. This can occur, for example, if an error occurs or if the transaction is refused.

reason field values

The value of the reason field varies depending on whether the outcome of the event is successful or not (successtrue or false):

If... ...then:
  • eventCode = AUTHORISATION
  • success = true
  • paymentMethod = visa , mc or amex

reason includes the following details:

  • Authorisation code
  • Last 4 digits of the card
  • Card expiry date

Format:

6-digit auth code:last 4 digits:expiry date

Example:

874574:1935:11/2012

  • success = false
reason includes a short message with an explanation for the refusal.
  • eventCode = REPORT_AVAILABLE
reason includes the download URL where you can obtain a copy of the report.
  • eventCode = PAIDOUT_REVERSED

reason field in the notification contains the bank statement description if present, else it contains PaidOutReversed .