Mastercard · Schema
Mastercard Payment
A payment transaction processed through the Mastercard network, representing a transfer of funds between a payer and payee. Applicable across Mastercard Send, Account to Account Commerce, Bill Pay, and checkout solutions.
Credit CardsDigital IdentityFinancial ServicesFraud DetectionOpen BankingPayments
Properties
| Name | Type | Description |
|---|---|---|
| paymentId | string | Unique identifier for the payment, generated using UUID logic to unambiguously link request and response messages. |
| paymentType | string | Classification of the payment indicating its purpose and processing path. |
| amount | string | Payment amount without decimal separators. The number of implied decimal places depends on the currency. For example, 10350 in USD represents $103.50. |
| currency | string | ISO 4217 numeric currency code for the payment amount. |
| status | string | Current status of the payment in its lifecycle. |
| timestamp | string | Timestamp of the payment initiation in ISO 8601 format with timezone offset. |
| sender | object | The party initiating or funding the payment. |
| recipient | object | The party receiving the payment funds. |
| cardNumber | string | Primary Account Number (PAN) of the card used for the payment. Must pass Luhn algorithm validation. |
| tokenNumber | string | Payment token representing the card number for tokenized transactions (MDES). |
| merchantId | string | Card acceptor or merchant unique identification number assigned by the acquirer. |
| merchantName | string | Name of the card acceptor or merchant. |
| merchantCategoryCode | string | Four-digit ISO 18245 Merchant Category Code (MCC) classifying the type of business. |
| acquirerId | string | Interbank Card Association (ICA) number of the acquiring institution. |
| icaNumber | string | ICA number of the issuer or acquirer initiating the request. |
| authorizationCode | string | Authorization code returned by the issuer for an approved transaction. |
| billingAmount | string | Amount appearing on the cardholder statement in the billing currency, without decimals. |
| billingCurrency | string | ISO 4217 numeric currency code for the billing amount. |
| conversionRate | string | Currency conversion rate applied when the transaction and billing currencies differ. |
| network | string | Payment network through which the transaction was processed. |
| channel | string | The channel through which the payment was initiated. |
| posEntryMode | string | Point of service entry mode indicating how the card data was captured at the terminal. |
| terminalId | string | Unique code identifying a terminal at the card acceptor location. |
| settlementDate | string | Date on which the transaction settles, in YYYYMMDD format. |
| referenceId | string | External reference identifier provided by the originator for reconciliation. |
| memo | string | Brief description or comment provided by the originator supporting the payment. |