Fraud Notifications

Get Fraud Notification

Returns the Fraud Notification identified by the specified key.

Requires fraudNotifications:Get permission.

get/fraudNotifications/{fraudNotificationKey}

Request

Path parameters

fraudNotificationKeystring required

Uniquely identifies a Fraud Notification

Example:frn-1JRadf2ffdfrdPMf2XrS2

Uniquely identifies a Fraud Notification.

Response

The referenced Fraud Notification

keystring required

Uniquely identifies a Fraud Notification

network'mastercard' | 'visa' | 'american-express' required

The card network

agentKeystring required

Uniquely identifies an Agent

merchantKeystring required

Uniquely identifies a Merchant

purchaseDatestring date required

Date when the purchase was done

fraudReportingDatestring date required

Date when the Fraud Notification was received by the Card Network. This is specific for each network. For Mastercard this is the TLL8 "Fraud Posted Date". For VISA this is the TC90 "Processing Date".

midstring required

Merchant ID assigned to the merchant (or Payfac) by the acquirer. Acceptors that use the same BIN, Doing Business As name, and location must have the same mid. Acceptors that use the same BIN cannot share a mid if they have a different Doing Business As name or location.

createdstring date-time required

The date and time this object was created

versioninteger required

The version of this object

status'active' | 'archived' required

The status of a Fraud Notification.

Example response

{
  "key": "frn-1JRadf2ffdfrdPMf2XrS2",
  "agentKey": "cgt-1UF2NafdfrdPMf2XrS2",
  "merchantKey": "mct-123dinkqFqfq3q2f2adfa",
  "merchantAcceptorRef": {
    "key": "mac-1JRadf2ffdfrdPMf2XrS2",
    "version": 1
  },
  "chargeInfo": {
    "arn": "12345678901234567890123",
    "localTransactionDateTime": "2021-05-27T10:57:52Z",
    "amount": {
      "value": 2599,
      "currency": "EUR"
    },
    "chargeKey": "chg-1e1dAHhgstYTUhlphPzZ",
    "transactionReference": "Dz3dIzE74EfH1HeTInyE",
    "clearingDateTime": "2021-05-27T10:57:52Z"
  },
  "cardInfo": {
    "last4": "0905"
  },
  "fraudAmount": {
    "value": 2599,
    "currency": "EUR"
  },
  "fraudType": {
    "typeCode": "01",
    "subTypeCode": "N"
  },
  "purchaseDate": "2021-05-27",
  "fraudReportingDate": "2021-05-28",
  "version": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.