# JPMC-PDP Documentation from https://developer.payments.jpmorgan.com # Notifications changelog ## February 26, 2026 **API Release v1.12.0** **New** **New features for Notifications API** | Feature name | Description | | --- | --- | | [Notification types](/docs/commerce/optimization-protection/capabilities/notifications/notification-types) | The following notification event types and sub types were added: - Tax event was added along with the following subtypes: - BackupWithholdingPending - BackupWithholdingPendingTwo - BackupWithholdingPrevented - BackupWithholdingPreventedTwo - BackupWithholdingStarted - BackupWithholdingStartedTwo - BackupWithholdingStopped - BackupWithholdingStoppedTwo - BulkConsumerProfileUpdateNotification sub-type was added to consumer profile events. - PaymentClosed sub-type was added to payment transaction events. - MopActivationCompleted and MopActivationDeclined subtypes were added to merchant status notification events. | | [API specification](/api/commerce/optimization-protection/notifications/notifications) | API specification version 1.12.0 was released. | The following fields were added in the API specification v1.12.0: **New fields added to the API Specification** | Field name | Description | Endpoint | | --- | --- | --- | | notifications.taxNotification | New enum values added to the request and response. - BackupWithholdingPending - BackupWithholdingPendingTwo - BackupWithholdingPrevented - BackupWithholdingPreventedTwo - BackupWithholdingStarted - BackupWithholdingStartedTwo - BackupWithholdingStopped - BackupWithholdingStoppedTwo | - POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) - PUT /subscriptions/{subscription-id} - [Update a specific subscription](/api/commerce/optimization-protection/notifications/notifications#/operations/v1UpdateSubscriptionBySubscriptionId) | | notifications.consumerProfileNotification | New enum value is added to the request and response. - BulkConsumerProfileUpdate | | notifications.merchantStatusNotification | New enum values added to the request and response. - MopActivationCompleted - MopActivationDeclined | | notifications.paymentUpdateNotification | New enum value is added to the request and response. - PaymentClosed | | taxNotification | Added to the response. | - GET /notifications/{notification-id} - [Get a notification by notification ID](/api/commerce/optimization-protection/notifications/notifications#/operations/v1GetNotificationByNotificationId) - GET /notifications - [Get all notifications within a date range by notification status](/api/commerce/optimization-protection/notifications/notifications#/operations/v1GetNotification) | | subscriptionChannel | New field added to request and response. | - POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) - GET /subscriptions/{subscription-id} - [Get a subscription by subscription ID](/api/commerce/optimization-protection/notifications/notifications#/operations/v1GetSubscriptionBySubscriptionId) - PUT /subscriptions/{subscription-id} - [Update a specific subscription](/api/commerce/optimization-protection/notifications/notifications#/operations/v1UpdateSubscriptionBySubscriptionId) | **Change** The following fields were updated in the API specification v1.12.0: **Field changes in the API specification** | Field name | Description | Endpoint | | --- | --- | --- | | subscriptionChannels | Deprecated field | - POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) - GET /subscriptions/{subscription-id} - [Get a subscription by subscription ID](/api/commerce/optimization-protection/notifications/notifications#/operations/v1GetSubscriptionBySubscriptionId) - PUT /subscriptions/{subscription-id} - [Update a specific subscription](/api/commerce/optimization-protection/notifications/notifications#/operations/v1UpdateSubscriptionBySubscriptionId) | ## September 19, 2025 **API Release v1.11.0** **New** **New features for Notifications API** | Feature name | Description | | --- | --- | | [Notification types](/docs/commerce/optimization-protection/capabilities/notifications/notification-types) | The following notification event types and sub types were added: - ACH status event was added along with the following subtypes: - AchReturnReceived - Direct Debit Account update event was added along with the following subtypes: - DirectDebitAccountUpdateSuccess - DirectDebitAccountUpdateFailure - DirectDebitAccountUpdatePending - Pay by Bank event subtypes that were added: - MicroDepositInitiated - MicroDepositSent - MicroDepositReadyToValidate - MicroDepositVerificationFailed - MicroDepositVerified - RecipientAccountValidation - Consume profile event subtypes that were added: - PaymentMethodCreated - PaymentMethodDeleted - Account update event for embedded payments was added along with the following subtypes: - AccountCreated - AccountOverdrawn - AccountClosed - RecipientAccountValidation - Allocation order instruction event for embedded payments was added along with the following subtype: - AllocationOrderInstructionUpdate - Allocation order settlement event for embedded payments was added along with the following subtype: - PspSettlementTransferUpdate - DistributionTransferUpdate - PlatformSettlementTransferUpdate - Processing threshold event for embedded payments was added along with the following subtype: - ProcessingThresholdStatus | | [API specification](/api/commerce/optimization-protection/notifications/notifications) | API specification version 1.11.0 was released. | The following fields were added in the API specification v1.11.0: **New fields added to the API Specification** | Field name | Description | Endpoint | | --- | --- | --- | | notifications.achStatusNotification | New enum values added to the request and response. - AchReturnReceived | - POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) - PUT /subscriptions/{subscription-id} - [Update a specific subscription](/api/commerce/optimization-protection/notifications/notifications#/operations/v1UpdateSubscriptionBySubscriptionId) | | notifications.directDebitAccountNotification | New enum values added to the request and response. - DirectDebitAccountUpdateSuccess - DirectDebitAccountUpdateFailure - DirectDebitAccountUpdatePending | | notifications.accountUpdateNotification | New enum values added to the request and response. - MicroDepositInitiated - MicroDepositSent - MicroDepositReadyToValidate - MicroDepositVerificationFailed - MicroDepositVerified - RecipientAccountValidation - AccountCreated - AccountOverdrawn - AccountClosed - RecipientAccountValidation | | notifications.consumerProfileCreated | New enum values added to the request and response. - paymentMethodCreated - paymentMethodDeleted | | notifications.allocationOrderInstructionNotification | New enum values added to the request and response. - AllocationOrderInstructionUpdate | | notifications.allocationOrderSettlementNotification | New enum values added to the request and response. - PspSettlementTransferUpdate - DistributionTransferUpdate - PlatformSettlementTransferUpdate | | notifications.processingThresholdNotification | New enum values added to the request and response. - ProcessingThresholdStatus | | achStatusNotification | Added to the response. | - GET /notifications/{notification-id} - [Get a notification by notification ID](/api/commerce/optimization-protection/notifications/notifications-oas.html#/operations/v1GetNotificationByNotificationId) - GET /notifications - [Get all notifications within a date range by notification status](/api/commerce/optimization-protection/notifications/notifications-oas.html#/operations/v1GetNotification) | | directDebitAccountNotification | | consumerProfileCreated | | allocationOrderInstructionNotification | | allocationOrderSettlementNotification | | processingThresholdNotification | ## March 15, 2025 **API Release v1.9.10** **New** **New features for Notifications API** | Feature name | Description | | --- | --- | | [Notification types](/docs/commerce/optimization-protection/capabilities/notifications/notification-types) | The following notification event types and sub types were added: - Payout event subtypes that were added: - PayoutRejected - PayoutFailureResolved - PayoutUnderReviewReleased - PayoutRejectedResolved - Merchant Status event subtypes that were added: - MerchantSuspendedAutoblock - MerchantSuspendedWithFundHold - MerchantSuspendedWithoutFundHold - QR Code event was added along with the following subtypes: - QRCodeCreated - QRCodeExpired - QRCodePaid - QRCodeSettlementProcessing - QRCodeCancelled | | [Public keys](/docs/commerce/optimization-protection/capabilities/notifications/public-keys) | Verify if the source of the callback notification is valid and from a secure J.P. Morgan system using elliptic curve public keys. | | [API specification](/api/commerce/optimization-protection/notifications/notifications) | API specification version 1.9.10 was released. | The following fields were added in the API specification v1.9.10: **New fields added to the API Specification** | Field name | Description | Endpoint | | --- | --- | --- | | notifications.payoutNotification | New enum values added to the request and response. - PayoutRejected - PayoutFailureResolved - PayoutUnderReviewReleased - PayoutRejectedResolved | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | notifications.merchantStatusNotification | New enum values added to the request and response. - MerchantSuspendedAutoblock - MerchantSuspendedWithFundHold - MerchantSuspendedWithoutFundHold | | notifications.qrCodeStatusNotification | New enum values added to the request and response. - QRCodeCreated - QRCodeExpired - QRCodePaid - QRCodeSettlementProcessing - QRCodeCancelled | | keys | Added to the response. | GET /public-keys - [Get a notification public key](/api/commerce/optimization-protection/notifications/notifications#/paths/public-keys/get) | **Change** The following fields were updated in the API specification v1.9.10: **Field changes in the API specification** | Field name | Description | Endpoint | | --- | --- | --- | | publicKey | Deprecated from the response. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | ## December 3, 2024 **API Release v1.9.1** **New** **New features for Notifications API** | Feature name | Description | | --- | --- | | [Notification types](/docs/commerce/optimization-protection/capabilities/notifications/notification-types) | New Entity onboarding notification event subtypes were added: - EntityOnboardingReviewInProgress - EntityOnboardingReviewInProgress - EntityOnboardingNew (coming soon) - EntityOnboardingApproved (coming soon) - EntityOnboardingDeclined (coming soon) | | [API specification](/api/commerce/optimization-protection/notifications/notifications) | API specification version 1.9.1 was released. | The following fields were added in the API specifications v1.9.1: **New fields added to the API Specification** | Field name | Description | Endpoint | | --- | --- | --- | | notifications.entityOnboardingNotification | New enum values added to the request and response. - EntityOnboardingReviewInProgress - EntityOnboardingReviewInProgress - EntityOnboardingNew - EntityOnboardingApproved - EntityOnboardingDeclined | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | **Change** The following fields were updated in the API specification v1.9.1: **Field changes in the API specification** | Field name | Description | Endpoint | | --- | --- | --- | | notificationType | Description was updated to reflect the correct subtype name format. | GET /notifications/{notification-id} - [Get a notification by notification ID](/api/commerce/optimization-protection/notifications/notifications#/operations/v1GetNotificationByNotificationId) | | notificationSubType | ## November 8, 2024 **API Release v1.9.0** **New** **New features for Notifications API** | Feature name | Description | | --- | --- | | [Notification types](/docs/commerce/optimization-protection/capabilities/notifications/notification-types) | New notification event types and subtypes were added: - Account updater events - Refund events - Payment transaction events - PaymentVoid - Report status events - Recommendation events | | [Security preferences](/docs/commerce/optimization-protection/capabilities/notifications/security-preferences) | Security preferences allows you to have Open Authorization (OAuth) protected callback URLs where webhook notifications are delivered using the authorization details you provide in securityPreferences. | | [API specification](/api/commerce/optimization-protection/notifications/notifications) | API specification version 1.9.0 was released. | The following fields were added in the API specification v1.9.0: **New fields added to the API Specification** | Field name | Description | Endpoint | | --- | --- | --- | | notifications.refundUpdateNotification | Added to the request and response. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | securityPreferences.webhookAuthorizationType | Added to the request. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | securityPreferences.tokenEndpointAuthorizationType | | securityPreferences.mTLSEnabled | | securityPreferences.authorizationDetails | | securityPreferences.headerFields | | securityPreferences.signingAlgorithm | **Change** The following fields were updated in the API specification v1.9.0: **Field changes in the API specification** | Field name | Description | Endpoint | | --- | --- | --- | | notifications.paymentUpdateNotification | Added new enum value: PaymentVoid to request and response. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | notifications.accountUpdateNotification | Added new enum value: AccountUpdaterStatus to request and response. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | securityPreferences.oAuthNotificationEnabled | Deprecated from the request. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | securityPreferences.sslAuthNotificationEnabled | | securityPreferences.oAuthDetails | ## October 22, 2024 **API Release v1.8.2** **New** **New features for Notifications API** | Feature name | Description | | --- | --- | | [Notification types](/docs/commerce/optimization-protection/capabilities/notifications/notification-types) | New notification event types were added: - Digital onboarding events - Entity onboarding events - Merchant status events - Payout events - 3-D secure events - Report status events - Recommendation events | | [API specification](/api/commerce/optimization-protection/notifications/notifications) | API specification version 1.8.2 was released. | The following fields were added in the API specification v1.8.2: **New fields added to the API Specification** | Field name | Description | Endpoint | | --- | --- | --- | | entity-id | Added to the request header. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | entity-type | Added to the request header. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | recipientDetails | Added to the request and response. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | recipientDetails.firstName | | recipientDetails.lastName | | recipientDetails.emailAddress | | recipientDetails.telephoneNumber | | recipientDetails.telephoneCountryCode | | notifications.entityOnboardingNotification | | notifications.merchantStatusNotification | | notifications.payoutNotification | | notifications.reportStatusNotification | | notifications.authenticationUpdateNotification | | notifications.recommendationNotification | | subscriptionChannels | **Change** **Feature changes to Notifications API** | Feature name | Description | | --- | --- | | Order notifications | Order notification was removed. | | Product onboarding notifications | Product onboarding notifications was removed. | The following fields were updated in the API specification v1.8.2: **Field changes in the API specification** | Field name | Description | Endpoint | | --- | --- | --- | | merchant-id | Deprecated from the request header. | All endpoints. | | notifications.orderUpdateNotification | Deprecated from the request and response. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | notifications.productOnboardingNotification | Deprecated from the request and response. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | ## June 2, 2024 **API Release v1.7.1** **New** **New features for Notifications API** | Feature name | Description | | --- | --- | | [Security preferences](/docs/commerce/optimization-protection/capabilities/notifications/security-preferences) | Security preferences provides you the option to add an additional layer of security by allowing you to add Open Authentication (OAuth) and Secure Socket Layer (SSL) certificates authentication on webhook notifications. | | [Public keys](/docs/commerce/optimization-protection/capabilities/notifications/public-keys) | A public key is a cipher that allows you to verify if the source of the callback notification is valid and from a secure J.P. Morgan system. | | [API specification](/api/commerce/optimization-protection/notifications/notifications) | API specification version 1.7.1 was released. - Added new endpoint: GET /publicKeys - [Get a public key by merchant ID](/api/commerce/optimization-protection/notifications/notifications#/operations/v1PublicKeyGet) | The following fields were added in the API specification v1.7.1: **New fields added to the API Specification** | Field name | Description | Endpoint | | --- | --- | --- | | publicKeyIdentifier | Added to the response. | GET /publicKeys - [Get a public key by merchant ID](/api/commerce/optimization-protection/notifications/notifications#/operations/v1PublicKeyGet) | | publicKeyText | | publicKeyExpirationDate | | securityPreferences | Added to the request. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) | | securityPreferences.oAuthNotificationEnabled | | securityPreferences.sslAuthNotificationEnabled | | securityPreferences.headerFields | | securityPreferences.oAuthDetails | | securityPreferences.oAuthDetails.oAuthClientSecret | | securityPreferences.oAuthDetails.oAuthClientId | | securityPreferences.oAuthDetails.tokenURL | **Change** **Feature changes to Notifications API** | Feature name | Description | | --- | --- | | Dispute notifications | Dispute notification was removed. | The following fields were updated in the API specification v1.7.1: **Field changes in the API specification** | Field name | Description | Endpoint | | --- | --- | --- | | notifications.disputeNotification | Deprecated from the request and response. | All endpoints. | | secretKey | Deprecated from the response. | POST /subscriptions - [Subscribe to a notification](/api/commerce/optimization-protection/notifications/notifications#/operations/v1CreateSubscription) |