Mastercard · Schema

TransactionAcknowledgement

Credit CardsDigital IdentityFinancial ServicesFraud DetectionOpen BankingPaymentsFortune 500

Properties

Name	Type	Description
paymentRequestLifecycleId	string	Unique identifier assigned by Mastercard, to identify the payment request in subsequent transactions or services.
endToEndId	string	Unique identifier assigned by Creditor to identify Payment Request in their system.
instructionId	string	Unique identifier for the transaction assigned by the transaction initiator (CSP).
accountServicerReference	string	Unique identifier assigned by Mastercard, to identify a particular payment (also referred to as settlement identifier) associated with a Payment Request.
reconId	string	Reconciliation identifier assigned by Mastercard to the transaction.
confirmationExpiryTimeInterval	number	Time window given in seconds within which the Payment Confirmation must be received by the Mastercard.
paymentRequestType	string	Set by the Creditor/CSP to define the settlement type of the Payment Request. * Refer to Codes and Formats section for more details.
transactionCreationDateTime	string	ISO 8601 format date and time in Coordinated Universal Time (UTC) the Payment Request was created.
instructedAmount	string	The total amount of the payment request, as specified by the Creditor.
purpose	string	Set by Creditor/CSP to indicate the Payment Request type. * Refer to Codes and Formats section for more details.
categoryPurpose	string	Set by the Creditor/CSP to offer specific transaction processing. * Refer to Codes and Formats section for more details.
restriction	string	Set by the Creditor/CSP to communicate any restrictions to be verified by DSP before payment authorization. * Refer to Codes and Formats section for more details.
creditAccountAllowed	boolean	Indicator to specify Credit account can be used for the payment.
strongCustomerAuthentication	boolean	Indicates a request from Creditor to DSP to step-up authentication for the transaction.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "TransactionAcknowledgement",
  "type": "object",
  "properties": {
    "paymentRequestLifecycleId": {
      "type": "string",
      "description": "Unique identifier assigned by Mastercard, to identify the payment request in subsequent transactions or services."
    },
    "endToEndId": {
      "type": "string",
      "description": "Unique identifier assigned by Creditor to identify Payment Request in their system."
    },
    "instructionId": {
      "type": "string",
      "description": "Unique identifier for the transaction assigned by the transaction initiator (CSP)."
    },
    "accountServicerReference": {
      "type": "string",
      "description": "Unique identifier assigned by Mastercard, to identify a particular payment (also referred to as settlement identifier) associated with a Payment Request."
    },
    "reconId": {
      "type": "string",
      "description": "Reconciliation identifier assigned by Mastercard to the transaction."
    },
    "confirmationExpiryTimeInterval": {
      "type": "number",
      "description": "Time window given in seconds within which the Payment Confirmation must be received by the Mastercard."
    },
    "paymentRequestType": {
      "type": "string",
      "description": "Set by the Creditor/CSP to define the settlement type of the Payment Request. * Refer to Codes and Formats section for more details."
    },
    "transactionCreationDateTime": {
      "type": "string",
      "description": "ISO 8601 format date and time in Coordinated Universal Time (UTC) the Payment Request was created."
    },
    "instructedAmount": {
      "type": "string",
      "description": "The total amount of the payment request, as specified by the Creditor."
    },
    "purpose": {
      "type": "string",
      "description": "Set by Creditor/CSP to indicate the Payment Request type. * Refer to Codes and Formats section for more details."
    },
    "categoryPurpose": {
      "type": "string",
      "description": "Set by the Creditor/CSP to offer specific transaction processing. * Refer to Codes and Formats section for more details."
    },
    "restriction": {
      "type": "string",
      "description": "Set by the Creditor/CSP to communicate any restrictions to be verified by DSP before payment authorization. * Refer to Codes and Formats section for more details."
    },
    "creditAccountAllowed": {
      "type": "boolean",
      "description": "Indicator to specify Credit account can be used for the payment."
    },
    "strongCustomerAuthentication": {
      "type": "boolean",
      "description": "Indicates a request from Creditor to DSP to step-up authentication for the transaction."
    }
  }
}