Notifications

Overview

Forter enables merchants to receive updates when a card, the underlying card of a token, or a network token is updated. These notifications include relevant properties of the card - excluding any PCI data.

Setup

To enable notifications, Forter requires two things:

  • An endpoint to which the notifications will be sent.
  • An HMAC signing key, which allows the merchant to verify that the request originated from Forter.

Alternatively, Forter can generate the signing key on your behalf and share it securely. Please provide the necessary details to your implementation engineer, and Forter will ensure proper configuration.

Update Scenarios

The following events will trigger a notification:

  • A card or the underlying card of a token is updated.
  • A network token or its underlying card is updated.
  • A card or token is updated via batch Account Updater. This scenario is optional, as it may result in a large volume of updates. Please speak with your implementation manager to enable it.

Example Payload

{
  "card": {
    "bin": "411111",
    "lastFourDigits": "1111",
    "expirationMonth": 12,
    "expirationYear": 2028
  },
  "networkToken": {
    "token": "2222850249903093",
    "state": "ACTIVE",
    "expirationMonth": 12,
    "expirationYear": 2028,
    "paymentAccountReference": "5001CKVAXG3BF45LG87F63JVX3AQ0"
  },
  "updateSource": "AU", // "AU" or "NT"
  "changedFields": {
    "bin": "411111"
  }
}