Skip to main content
Online Payments

Digital device ID

Digital Device ID provides issuers with device-level intelligence during authorization. It helps improve approval rates, reduce false declines, and strengthen fraud assessment. Checkout generates and passes the Device ID on behalf of merchants, so merchants do not need additional integration work. This capability supports network initiatives such as Visa Digital Commerce Authentication Program (DCAP).

Expected notification value: digitalDeviceIdentifier

HTTP method: GET

Endpoint: /checkout/notifications

Response:

{
  "messages": [
    {
      "messageInfo": {
        "messageId": "021de803-736a-4d76-ad1f-b63353627500",
        "receiptHandle": ""
      },
      "createdAt": "2026-07-07T21:01:05.487345Z",
      "tokenNotification": {
        "token": "6393583818339275",
        "tokenType": "TOKEN_TYPE_ACQUIRER",
        "checkoutReference": "8259381440",
        "fraudCheckStatus": "FRAUD_CHECK_STATUS_APPROVED",
        "status": "STATUS_SUCCESS",
        "responseCode": "",
        "responseMessage": "",
        "merchantOrderNumber": "8259381440",
        "requestId": "0f8de64eceb34301b52453",
        "digitalDeviceIdentifier": "019f3e3d-6ee0-77d3-a596-ab64edc1168f"
      },
      "merchantOrderNumber": "8259381440",
      "requestId": "0f8de64eceb34301b52453"
    },
    {
      "messageInfo": {
        "messageId": "b02ed245-c578-4c56-98d0-f23d01b20055",
        "receiptHandle": ""
      },
      "createdAt": "2026-07-07T21:01:05.499377Z",
      "orderNotification": {
        "checkoutIntent": "CHECKOUT_INTENT_TOKENIZE_ONLY",
        "status": "STATUS_SUCCESS",
        "transactionReference": "",
        "mitTransactionReference": "",
        "checkoutReference": "8259381440",
        "totalAmount": {
          "amount": "0",
          "currencyCode": "USD",
          "decimalCount": 6
        },
        "fraudCheckStatus": "FRAUD_CHECK_STATUS_APPROVED",
        "cardTypeIndicators": {
          "durbinRegulated": false,
          "level3Eligible": false,
          "issuanceCountry": "",
          "cardTypeCategory": "",
          "cardIssuerName": "",
          "cardProductName": "",
          "cardProductType": []
        },
        "last4OfCardPan": "4455",
        "responseCode": "",
        "responseMessage": "",
        "mandateAcknowledgement": [
          {
            "mandates": [
              {
                "mandateRef": "Mandate Ref",
                "acknowledgementType": "ACKNOWLEDGEMENT_TYPE_EXPLICIT",
                "acceptedFlag": "ACCEPTED_FLAG_Y",
                "mandateVerbiage": "Thank you for your order. Please shop again.",
                "mandateType": "MANDATE_TYPE_CARD"
              }
            ],
            "device": {
              "deviceIp": "146.143.4.20",
              "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36"
            },
            "acceptedTimestamp": "2026-07-07T21:01:05.474Z",
            "consents": [
              {
                "acknowledgementType": "ACKNOWLEDGEMENT_TYPE_EXPLICIT",
                "acceptedFlag": "ACCEPTED_FLAG_N",
                "consentVerbiage": "",
                "consentType": "CONSENT_TYPE_PROFILE_CONSENT"
              }
            ]
          }
        ],
        "merchantOrderNumber": "8259381440",
        "paymentMethod": {
          "card": {
            "cardTypeIndicators": {
              "durbinRegulated": false,
              "level3Eligible": false,
              "issuanceCountry": "",
              "cardTypeCategory": "",
              "cardIssuerName": "",
              "cardProductName": "",
              "cardProductType": []
            },
            "last4CardNumber": "4455",
            "expiry": {
              "month": 12,
              "year": 2043
            },
            "cardType": "VI",
            "cardTypeName": "VISA",
            "networkResponse": {
              "addressVerificationResult": "",
              "addressVerificationResultCode": "",
              "cardVerificationResult": "",
              "cardVerificationResultCode": ""
            }
          },
          "paymentMethodType": "PAYMENT_METHOD_TYPE_CODE_CARD",
          "maskedAccountNumber": "444444XXXXXX4455",
          "approvalCode": ""
        },
        "requestId": "0f8de64eceb34301b52453",
        "accountHolder": {
          "billingAddress": {
            "recipientFullName": "",
            "line1": "12300 Sunrise Valley Dr",
            "line2": "",
            "line3": "",
            "city": "Reston",
            "state": "VA",
            "country": "US",
            "postalCode": "20191",
            "email": "",
            "phone": ""
          }
        },
        "shopperEmailId": "",
        "threeDomainSecureTransaction": {
          "threeDSTransactionStatus": "",
          "challengeAuthenticationMethod": "",
          "challengeAuthenticationType": "",
          "authenticationStatusReasonText": "",
          "authenticationType": "",
          "threeDSVersion": "",
          "threeDSAuthenticationAmount": "0",
          "threeDSDirectoryServerTransactionId": "",
          "threeDomainSecureAuthenticationMethodCode": "",
          "threeDSChallengeType": "",
          "issuerAssignedAuthenticationFraudScore": ""
        },
        "fraudCheckResult": {
          "fraudCheckStatus": "FRAUD_CHECK_STATUS_APPROVED",
          "deviceDataUsed": true
        },
        "consumerAcknowledgement": [
          {
            "mandates": [
              {
                "referenceNumber": "Mandate Ref",
                "mandateType": "MANDATE_TYPE_CARD",
                "contractSigned": true,
                "agreementDescription": "Thank you for your order. Please shop again.",
                "presentationMode": "PRESENTATION_MODE_EXPLICIT"
              }
            ],
            "consents": [
              {
                "consentType": "CONSENT_TYPE_PROFILE_CONSENT",
                "contractSigned": false,
                "agreementDescription": "",
                "presentationMode": "PRESENTATION_MODE_EXPLICIT"
              }
            ]
          }
        ],
        "currentPaymentAttemptCount": "1",
        "maximumPaymentAttemptCount": "3",
        "totalTransactionAmount": "0",
        "partialAuthorizationSupport": "",
        "partialAuthorization": false,
        "requestedAuthorizationAmount": "0",
        "totalAuthorizedAmount": "0",
        "currencyCode": "USD"
      },
      "merchantOrderNumber": "8259381440",
      "requestId": "0f8de64eceb34301b52453"
    }
  ],
  "nextPageToken": ""
}
Is this page helpful?