Notifications

Notifications


There are two ways where the merchant can be notified of Shield actions.

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"
  }
}

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


Was this article helpful?