Beta version available

The Global Payments 2 API is currently available in beta. Contact our team to start your integration process.

Callbacks

Overview

J.P. Morgan’s Global Payments API supports callbacks to notify your application of real-time status updates when an event occurs. Callbacks are more efficient for both the API provider and clients because applications don’t need to frequently poll for data to get status updates.

Before you begin

To enable callbacks, you need to:

Contact your representative to initiate an implementation request when you are ready to start using the Treasury Services API.
Complete the implementation process to receive the required certificate to set up a new callback. For more information, see Getting Started.

Tip

How callbacks work

When a payment initiation request is received, it is acknowledged with a successful 202 HTTP status that includes the endToEndId and firmRootId in the response body. A payment then triggers a callback to your registered callback URL with a PENDING status and continues to send you callbacks as the payment transitions through further status changes.

The payment initiation status callback response is usually received within 30 seconds. The Global Payments API always provides the latest and most accurate information about the payment. If an HTTP error occurs, we automatically retry until the error is resolved.

Payment status callbacks

Callbacks are responses sent to your client through the Global Payments API. For more information, see the Global Payments Open API Specification.

Confirm callback response

The following response shows a payment in the REJECTED state:

Example payment response: REJECTED

Json

{
  "callbacks": [
    {
      "endToEndId": "MY20230727_0219",
      "createDateTime": "2023-07-27T07:41:54.773Z",
      "paymentStatus": "REJECTED",
      "firmRootId": "53038faa-43f6-42fc-9545-648fd2dab411",
      "exceptions": [
        {
          "errorCode": "10004",
          "errorDescription": "Error occurred on /requestedExecutionDate",
          "ruleDefinition": "Date validation failure"
        }
      ]
    }
  ]
}

Status response types

The following table lists supported status response types for the Global Payments API.

Global Payments API status response types
Status	Description
PENDING	The payment is pending.
PENDING_POSTING	The payment is not posted to the beneficiary account.
COMPLETED	The payment was completed.
COMPLETED_CREDITED	The payment is credited to the beneficiary’s account.
REJECTED	The payment was rejected. For more information about the exception object for error details, see Callbacks in the Open API Specification.
RETURNED	The payment was returned to the debtor party.
BLOCKED	The payment was blocked due to a sanctions issue.
WAREHOUSED	The payment request was received and will be processed on the requested execution date.

Next steps

Learn how to test using mock data to trigger specific responses and error scenarios.