Notifications

Two ways the merchant can be notified of Shield actions:

1. Webhooks

If Shield has performed an action, it will be communicated through the webhook. It will include the following information:

Action: This can be Warn, Refuse or Exempt
Check: Description of the rule
Details: The rule details

Example:

{
  "Transaction": {
    "Key": "xxx",
    "Invoice": "iDEAL_0001",
    "ServiceCode": "ideal",
    "Status": {
      "Code": {
        "Code": 690,
        "Description": "Rejected"
      },
      "SubCode": {
        "Code": "S104",
        "Description": "Buckaroo Shield refused the payment after-the-fact due to suspected fraud. It will be refunded."
      },
      "DateTime": "2022-10-06T17:26:09"
    },
    "IsTest": true,
    "Order": null,
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "TransactionType": "C021",
    "Services": [
      {
        "Name": "ideal",
        "Action": null,
        "Parameters": [
          {
            "Name": "consumerIssuer",
            "Value": "ABN AMRO"
          },
          {
            "Name": "transactionId",
            "Value": "0000000000000001"
          },
          {
            "Name": "consumerName",
            "Value": "John Smith"
          },
          {
            "Name": "consumerIBAN",
            "Value": "NL44RABO0123456789"
          },
          {
            "Name": "consumerBIC",
            "Value": "RABONL2U"
          }
        ],
        "VersionAsProperty": 2
      },
      {
        "Name": "Shield",
        "Action": null,
        "Parameters": [
          {
            "Name": "Action",
            "Value": "Refuse"
          },
          {
            "Name": "Check",
            "Value": "Fraudulous IBANs"
          },
          {
            "Name": "Details",
            "Value": "DataPoints.Iban = \"NL44RABO0123456789\""
          }
        ]
      }
    ],
    "CustomParameters": null,
    "AdditionalParameters": null,
    "MutationType": 1,
    "RelatedTransactions": null,
    "IsCancelable": false,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "J. de Tèster",
    "PayerHash": "XXX",
    "PaymentKey": "XXX",
    "Description": "Test transaction X"
  }
}

2. Email

The merchant can be notified via email of a Shield action. A list of comma separated emails can be set in https://Plaza.buckaroo.nl/Configuration/Shield/Miscellaneous