Standard notifications are webhooks generated on the plataforma de pagamentos da Adyen. They have the same format and are delivered in the same way across sales channels. Standard notifications inform you asynchronously of transaction details and updates to transactions.
In a point-of-sale integration, standard notifications may seem less important, because the terminal provides instant feedback: it immediately shows if a transaction is Approved or Declined. And even if you don't receive the Terminal API response with the transaction details, you can get the details through a transaction status request.
However, there are point-of-sale use cases that rely on standard notifications:
- Asynchronous requests:
- Referenced and unreferenced refunds.
- Asynchronous authorisation adjustment.
- Manual capture.
- Cancellation of uncaptured authorisations when using delayed automatic capture or manual capture.
- PSP reference-based reconciliation of offline payments.
- Customer insights through combining data from multiple sales channels.
- Recurring online payments after creating a token through an initial point-of-sale payment.
If you decide to implement standard notifications, you need to:
- Learn about notification webhooks.
- Select the additional data you want to receive in standard notifications.
Learn about notification webhooks
Refer to our notification webhooks documentation to:
- Set up standard notifications and other platform-generated webhooks.
- Verify the HMAC signature included in webhooks.
- Acknowledge webhooks with an HTTP 200 response code and [accepted] in the response body.
- Understand the structure of webhooks.
- Learn best practices for using webhooks.
Select additional data to receive
Standard notifications include a few details by default, as well as customizable additional data. Depending on your use case, you need to enable specific identifiers that you want to receive in the additional data of standard notifications.
- Set up a standard notification webhook, if you haven't done so already.
-
In your Customer Area, open the Standard notification you set up and select the additional settings you want to receive.
Some of the settings you may want to enable, are:
Identifier Additional setting to select Card alias Include Alias Info Funding source Include Funding Source Issuer country Include Issuer Country PAR Add Payment Account Reference Must be enabled under Developers > Additional data too.Recurring detail reference Can't be enabled in the webhook settings. Must be enabled under Developers > Additional data.Shopper email, shopper reference Include Shopper Details Token variant Include tokenTxVariant Must be enabled under Developers > Additional data too.BIN Include Card Bin POIID Include POS TerminalInfo Store name Include Store Tender reference, POIID Include POS Details -
To receive the PAR, the token variant, or the recurring detail reference in standard notifications, go to Developers > Additional data and enable these identifiers:
Identifier Additional data to select PAR Under Acquirer, select Payment account reference Token variant Under Card, select Token information for digital wallets Recurring detail reference Under Payment, select Recurring details When you enable identifiers under Developers > Additional data you also receive these identifiers in your API responses.
Example standard notification
The following example shows the standard notification webhook for a point-of-sale payment. The identifiers are in the additionalData object.
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": {
"alias": "M469509594859802",
"aliasType": "Default",
"authCode": "00",
"cardBin": "541333",
"cardSummary": "9999",
"expiryDate": "02/2028",
"fundingSource": "CREDIT",
"issuerCountry": "GB",
"recurring.shopperReference": "SREF12458",
"shopperEmail": "S.Hopper@example.com",
"shopperIP": "198.51.100.1",
"shopperReference": "SREF12458",
"store": "YOUR_STORE",
"tenderReference": "CYHG001647245627000",
"terminalId": "V400m-346403161"
},
"amount": {
"currency": "EUR",
"value": 12098
},
"eventCode": "AUTHORISATION",
"eventDate": "2021-04-14T15:30:14+02:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "902",
"operations": [
"CANCEL",
"CAPTURE",
"REFUND"
],
"paymentMethod": "mc",
"pspReference": "8825408195409505",
"reason": "00:9999:02/2028",
"success": "true"
}
}
]
}