Payment Card Revisions

Overview

When a payment card is issued or updated, the action is recorded in Highnote as a revision. A revision record captures the snapshot of the PaymentCard object before the changes to it were applied. The following types of payment card actions result in a revision:

• Issue
• Reissue
• Activate/deactivate
• Suspend
• Terminate
• Update other attributes: currently, only card form factor and card usage

You can use the Highnote API to view the revision on a payment card. The following revision data types are supported:

Revision type	Description
Card status	Available enums: ACTIVATION_REQUIRED, ACTIVE, SUSPENDED, CLOSED. See PaymentCardStatus
Card form factor	Available enums: PHYSICAL, VIRTUAL. See CardFormFactor
Expiration date	ISO 8601 UTC timestamp of payment card expiry date
Card usage	Available enums: MULTI_USE, SINGLE_USE. See CardUsage
Updated timestamp	ISO 8601 UTC timestamp when the revision took place
Status change reason	Available enums: CREATED, EXPIRED, LOST, STOLEN, OTHER. See PaymentCardStatusChangeReason

Use cases

• Traceability and Troubleshooting: By tracking when these changes were made (with the updatedAt timestamp), organizations can quickly trace the origins of issues or unauthorized modifications.
• Compliance and Auditing: Maintaining a thorough record of all updates assists in compliance with financial regulations, providing auditors with a transparent view of the card's history.
• Security and Fraud Prevention: Historical logs of status changes are invaluable for detecting patterns that may indicate fraudulent activity.
• Operational Insights: Analysis of updates over time can reveal trends in card usage and lifecycle management, informing strategic decisions.

Find payment card revisions

You can use the following FindPaymentCardRevisionSnapshot query to find revisions associated with a payment card. Additionally, the revisions attribute can be included on queries that support the PaymentCard object.

FindPaymentCardRevisionSnapshot

Query

query FindPaymentCardRevisionSnapshot($id: ID!, $first: Int, $after: String) {
  node(id: $id) {
    __typename
    ... on PaymentCard {
      id
      revisionSnapshots(first: $first, after: $after) {
        edges {
          node {
            __typename
            ... on PaymentCardSnapshot {
              id
              expirationDate
              expirationMonth
              expirationYear
              status
              statusChangeReason
              statusChangeMemo
              formFactor
              usage
              updatedAt
            }
          }
        }
      }
    }
  }
}

Variables

{
  "id": "<NODE_ID>",
  "first": 10,
  "after": "<CURSOR>"
}

⚠️ Please login to execute queries. Visit the dashboard to authenticate.

Result

{
  "data": {
    "node": {
      "__typename": "PaymentCard",
      "id": "<NODE_ID>",
      "revisionSnapshots": {
        "edges": [
          {
            "node": {
              "__typename": "PaymentCardSnapshot",
              "id": "cdrev_1",
              "expirationDate": "2026-07-01T07:00Z",
              "expirationMonth": "07",
              "expirationYear": "26",
              "status": "ACTIVE",
              "statusChangeReason": "CREATED",
              "statusChangeMemo": "",
              "formFactor": "VIRTUAL",
              "usage": "MULTI_USE",
              "updatedAt": "2024-07-25T21:31:46.836Z"
            },
            "__typename": "PaymentCardSnapshotEdge"
          }
        ],
        "__typename": "PaymentCardSnapshotConnection"
      }
    }
  },
  "extensions": {
    "requestId": "7bb9234a-0fe8-9156-83f0-d28c2c84684d",
    "rateLimit": {
      "cost": 23,
      "limit": 60060,
      "remaining": 56603
    }
  }
}