Error Response Example

If the validation result cannot be processed or reported successfully, the response may include an error status and error details.

{
  "PubToken": "182293241",
  "DelegateScaId": "82b44d02-71db-4d00-9b3d-9fb7c0aa5eaa",
  "PmReferenceId": "refId",
  "Status": "FAILWITHFEEDBACK",
  "Error": {
    "ReferenceNumber": "504023",
    "Description": "DelegateSca status reporting to 3DSProvider failed",
    "Message": "DelegateSca status reporting to 3DSProvider failed"
  }
}

DelegateSCACancelNotification Request

If the cardholder cancels the authentication, your system receives a DelegateSCACancelNotification request.

{
  "NotificationId": "f88458df-20ea-49b7-b890-119c2f5e8c6e",
  "PubToken": "123456789",
  "DelegateMethod": "push-confirmation",
  "FinancialInstitutionId": "f88458df-20ea-49b7-b890-119c2f5e8c6e",
  "Language": "en-EN",
  "DelegateScaId": "bcd507g1-7ec8-43b4-8a07-6c5e17078967",
  "CardScheme": "MasterCard",
  "CreatedMode": "GA",
  "Device": {
    "Channel": "BROWSER",
    "Ip": "string",
    "Language": "en-EN"
  },
  "MerchantInfo": {
    "Id": "mer-12345",
    "Name": "Amazon",
    "Country": "840",
    "Url": "https://amazon.com   ",
    "ChallengePreference": "no-preference",
    "RedirectAppUrl": "merchantScheme://appName?transID=b2385523-a66c-4907-ac3c-91848e8c0067"
  },
  "TransactionInfo": {
    "Type": "payment",
    "ProtocolVersion": "1.0.2",
    "Channel": "app",
    "DsTransactionId": "98315a91-e0b6-4fe0-8842-9ed82ea8ef0b",
    "Date": "2023-08-17T10:35:32.061Z",
    "Amount": "12345",
    "Currency": {
      "Code": "978",
      "Exponent": "2"
    },
    "Recur": {
      "Frequency": "30",
      "EndRecur": "20221212"
    },
    "Install": "5"
  },
  "DelegateStatus": "Cancelled"
}

Your Response to DelegateSCACancelNotification

Expected acknowledgement

Upon receipt of a cancellation request, your system should return a 200 HTTP response code for successful receipt. If the cancellation request cannot be processed, your system should return a 400 HTTP response code.