Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Standard notifications

Receive platform-generated standard notification webhooks on your back-end system.

Standard notifications are webhooks generated on the Adyen payments platform. 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:

If you decide to implement standard notifications, you need to:

  1. Learn about notification webhooks.
  2. 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.

  1. Set up a standard notification webhook, if you haven't done so already.
  2. 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
  3. 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.

Identifiers in a standard notification webhook
{
    "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"
            }
        }
    ]
}

See also