Skip to main content
Beta version

Welcome to the beta version of the Global Payments 2 API! For the generally available Global Payments API, refer to Global Payments. 

Get the status of a Real-Time Payments request

In this tutorial, you will learn how to use the Global Payments API to retrieve the status of an RTP request. By the end of this tutorial, you will know how to:

Use an endToEndId to manually check and confirm the status of your request.

Tip

The Global Payments API supports callbacks for automatic status updates.

Before you begin

To retrieve the status of an RTP request, you will need the following:

An endToEndId value for your payment request, which is provided in a successful payment response. 

Send a request

A successful response contains an endToEndId value that can be used to retrieve the details of the payment request. To do this, call a GET request to the /payments/status endpoint, appending your unique endToEndId to the end of the call:

Example of a RTP payment status request
Curl
curl --request GET \
  --url https://api-mock-payments.aws.jpmchase.net/payment/v2/payments/98275a2d-1e88-beed-6938-0521a7e0aesf/status \
  --header 'Accept: application/json' \
  --header 'Request-Id: 253f67f3-b640-44cb-aabd-2cc348b52678'

Confirm the response

The following example shows a status response for a pending transaction:

Example of a successful RTP payment response with PROCESSING status
Json
{
  "paymentId": "98275a2d-1e88-beed-6938-0521a7e0aesf",
  "paymentStatus": "PROCESSING",
  "paymentSubStatus": "PROCESSING_BY_JPM",
  "statusUpdatedAt": "2024-10-15T14:15:22Z",
  "requestedExecutionDate": "2024-10-15",
  "paymentIdentifiers": {
    "endToEndId": "pl210g9t231r13541130"
  },
  "transferType": "CREDIT",
  "paymentType": "RTP"
}

For a full list of supported status response types, see Callbacks.

Next steps

Learn how to retrieve the payment details of your RTP request.