💳 Payment API Changelog

🚀 Version 2.0 (2026-07-31)

📌 Summary

Version 2.0 introduces standardized naming conventions across endpoints and schemas, a major tokenization refactor, expanded payment categories/types, and richer PSP response metadata.

---

🌐 Endpoint & Path Updates

• Standardized casing for endpoints to maintain RESTful conventions:
  • /nonUI ➔ /nonUi
  • /prePaymentUI ➔ /prePaymentUi

---

🏗️ Schema Restructuring & Renaming

Simplified generic and inline schemas to align with domain-driven payment terminology:

---

🔐 Tokenization Overhaul

• Deprecated/Removed: StoreCardDetails, StoredCardList, and untokenized card schemasAdded: Consolidated TokenizeDetails schema supporting:
  • tokenizeFlag (Y, N, F)
  • profileRef, tokenRef, and tokenRefList fields

---

🏷️ Expanded Enums

• PaymentCategory: Added IPP
• PaymentType: Added CC-DC, CC-DS, CC-MP, CC-KP, CC-TP, and EXT.

---

📝 Property & Casing Standardizations

• notificationURLs ➔ notificationUrls
• terminalID ➔ terminalId
• previousPaymentID ➔ previousPaymentId

---

📊 Response & Field Additions

Expiration & Conversion Tracking

• CompletePaymentResult: Added linkExpiryDateTime, pspExpiryDateTime.
• IncompletePaymentResult: Added failedReason, pspExpiryDateTime, currencyConversionType, currencyConversionMerchantId, and preferredPaymentTypes.

Metadata Extensions

• CreditCardDetailsResponse: Added localScheme.
• PspResponseDetails: Added responseMessageID, responseToRequestMessageID, pspPaymentId, pspInvoiceNo, response63, paymentScheme, pacoIssuerCode, pspAccountNumber, pspCardNumber, acquirerName, and acquirerBackendMerchantId.
• AResACSChallenge: Marked cReq as deprecated (superseded by challengeHtml).