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 details of a Kinexys Digital Payments request

In this tutorial, you will learn how to use the Global Payments API to retrieve Kinexys Digital Payments details. By the end of this tutorial, you will know how to use the paymentId to retrieve the transaction details of your payment request.

Before you begin

To retrieve details of a Kinexys Digital Payments, you need:

  • A registered and fully onboarded Developer Account on the J.P. Morgan Payments Developer Portal.
  • An active project that provides you with the credentials used to make a request.
  • A J.P. Morgan Blockchain Deposit Accounts (BDA) opened at J.P. Morgan Chase Bank, N.A. 
  • A Demand Deposit Account (DDA) opened in an approved funding location in which you want to perform a Kinexys Digital Payments transaction.
Tip

In addition to regular Demand Deposit Accounts (DDA), select Client Money Accounts (CMA) and Mortgage Servicing Accounts (MSA) are supported by this product, subject to J.P. Morgan review.

Send a request

Request payloads for the Global Payments API have optional and required fields. Use the paymentId to retrieve Kinexys Digital Payments details.

Kinexys Digital Payments paymentId details request

To obtain the details of a payment send a GET HTTP request to the applicable URL, using the paymentId.

Example of a CAT GET HTTP using the paymentId to retrieve payment details:

Example of a Kinexys Digital Payments paymentId details request
Curl
curl --request GET \
  --url https://api-mock-payments.aws.jpmchase.net/payment/v2/payments/989a066e-2947-4fa9-9ec7-5d09b1917c11 \
  --header 'Accept: application/json' \
  --header 'Request-Id: 1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p'

Confirm the response

You will receive a successful response containing the details for your payment request.

Example of a Kinexys Digital Payments details response
Json
{
  "paymentId": "f0e5486f-898a-406c-9c1f-63a0789fd961",
  "paymentStatus": "PROCESSING",
  "statusUpdatedAt": "2024-10-30T14:15:22Z",
  "requestedExecutionDate": "2024-10-30",
  "paymentIdentifiers": {
    "endToEndId": "Kinexys2024_0834"
  },
  "transferType": "CREDIT",
  "value": {
    "currency": "USD",
    "amount": "6500"
  },
  "paymentType": "BLOCKCHAIN",
  "debtor": {
    "account": {
      "accountNumber": "940091064",
      "accountType": "BDA"
    }
  },
  "debtorAgent": {
    "financialInstitutionIds": [
      {
        "id": "CHASUS33",
        "idType": "BIC"
      }
    ]
  },
  "creditor": {
    "account": {
      "accountNumber": "80091097",
      "accountType": "BDA"
    }
  },
  "creditorAgent": {
    "financialInstitutionIds": [
      {
        "id": "CHASUS33",
        "idType": "BIC"
      }
    ]
  },
  "remittanceInformation": {
    "unstructuredInformation": [
      {
        "text": "Payment for container shipment"
      }
    ]
  }
}