Optimization Protection

Notifications changelog

February 26, 2026

API Release v1.12.0

New

New features for Notifications API
Feature name	Description
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 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 `PUT /subscriptions/{subscription-id}` - Update a specific subscription
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 `GET /notifications` - Get all notifications within a date range by notification status
`subscriptionChannel`	New field added to request and response.	`POST /subscriptions` - Subscribe to a notification `GET /subscriptions/{subscription-id}` - Get a subscription by subscription ID `PUT /subscriptions/{subscription-id}` - Update a specific subscription

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 `GET /subscriptions/{subscription-id}` - Get a subscription by subscription ID `PUT /subscriptions/{subscription-id}` - Update a specific subscription

September 19, 2025

API Release v1.11.0

New

New features for Notifications API
Feature name	Description
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 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 `PUT /subscriptions/{subscription-id}` - Update a specific subscription
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 `GET /notifications` - Get all notifications within a date range by notification status
`directDebitAccountNotification`
`consumerProfileCreated`
`allocationOrderInstructionNotification`
`allocationOrderSettlementNotification`
`processingThresholdNotification`

March 15, 2025

API Release v1.9.10

New

New features for Notifications API
Feature name	Description
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	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 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
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

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

December 3, 2024

API Release v1.9.1

New

New features for Notifications API
Feature name	Description
Notification types	New Entity onboarding notification event subtypes were added: EntityOnboardingReviewInProgress EntityOnboardingReviewInProgress EntityOnboardingNew (coming soon) EntityOnboardingApproved (coming soon) EntityOnboardingDeclined (coming soon)
API specification	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

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
`notificationSubType`

November 8, 2024

API Release v1.9.0

New

New features for Notifications API
Feature name	Description
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	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 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
securityPreferences.`webhookAuthorizationType`	Added to the request.	`POST /subscriptions` - Subscribe to a notification
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
notifications.`accountUpdateNotification`	Added new enum value: AccountUpdaterStatus to request and response.	`POST /subscriptions` - Subscribe to a notification
securityPreferences.`oAuthNotificationEnabled`	Deprecated from the request.	`POST /subscriptions` - Subscribe to a notification
securityPreferences.`sslAuthNotificationEnabled`
securityPreferences.`oAuthDetails`

October 22, 2024

API Release v1.8.2

New

New features for Notifications API
Feature name	Description
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 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
`entity-type`	Added to the request header.	`POST /subscriptions` - Subscribe to a notification
`recipientDetails`	Added to the request and response.	`POST /subscriptions` - Subscribe to a notification
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
notifications.`productOnboardingNotification`	Deprecated from the request and response.	`POST /subscriptions` - Subscribe to a notification

June 2, 2024

API Release v1.7.1

New

New features for Notifications API
Feature name	Description
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	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 specification version 1.7.1 was released. Added new endpoint: `GET /publicKeys` - Get a public key by merchant ID

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
`publicKeyText`
`publicKeyExpirationDate`
`securityPreferences`	Added to the request.	`POST /subscriptions` - Subscribe to a notification
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