Skip to main content
Beta version available

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

Global Payments

Get the status of a Push to Card payment request

In this tutorial, you'll learn how to use the Global Payments API to retrieve the status of a Push to Card request.

By the end of this tutorial, you'll know how to:

  • Use the endToEndId to check and confirm the status of your request.
  • Interpret Push to Card response types.

Before you begin

To retrieve the status of a Push to Card request, you'll need an endToEndId value for your payment request, which is provided in a successful payment response. 

Create and send a status request

A successful response contains an endToEndId value that can be used to retrieve the status 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 transaction status request
Curl
curl --location 'https://api-mock.payments.jpmorgan.com/tsapi/v1/payments/status?endToEndId=1lv0t92e023g11354100'

The following response shows a payment in the PENDING status:

Example transaction status response: PENDING
Json
{
    "paymentStatus": {
        "createDateTime": "2022-06-28T00:00:01.000",
        "status": "PENDING"
    }
}

A rejected response contains an error code value, description, and a rule definition that can be used to determine the request failure.

The following response indicates a payment in the REJECTED status, including an additional field, externalCode, which applies only to rejections at the clearing level.

Example transaction status response: REJECTED
Json
{
    "paymentStatus": {
        "createDateTime": "2023-10-04T03:27:22.000",
        "status": "REJECTED",
        "exception": [
            {
                "errorCode": "11000",
                "errorDescription": "Amount of funds available to cover specified message amount is insufficient",
                "ruleDefinition": "Clearing/Regulatory failure",
                "externalCode": "AM04"
            }
        ]
    }
}

J.P. Morgan recommends reviewing the error codes section to understand the supported responses. If you need further assistance, contact your Client Service Account Manager.

Push to Card supports multiple response types, including PENDING, REJECTED, WAREHOUSED, COMPLETED, and RETURNED. For more information, see Response types.

Review supported response types.

Next steps