Skip to main content
Beta version available

Discover the Global Payments 2 API, now available in beta!

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 endToEndId or firmRootId 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.

Get Kinexys Digital Payments details

Request payloads for the Global Payments API have optional and required fields. Use one of the following options to retrieve Kinexys Digital Payments details.

  • firmRootId
  • endToEndId

Kinexys Digital Payments firmRootId details request

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

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

Kinexys Digital Payments firmRootId details request
Curl
curl --request GET \ --url https://api-mock.payments.jpmorgan.com/tsapi/v1/payments?firmRootId=98275a2d-1e88-beed-6938-0521a7e0oinc ' \ --header 'Accept: application/json'

Confirm firmRootId response

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

Kinexys Digital Payments firmRootId details request response
Json
{
  "payments": {
    "paymentIdentifiers": {
      "endToEndId": "202E092v021D35E4"
    },
    "requestedExecutionDate": "2033-06-10",
    "paymentCurrency": "USD",
    "paymentAmount": 6500,
    "transferType": "CREDIT",
    "paymentType": "BLOCKCHAIN",
    "debtor": {
      "debtorAccount": {
        "accountId": "8830699900",
        "accountType": "DDA"
      }
    },
    "debtorAgent": {
      "financialInstitutionId": {
        "bic": "CHASSGSG"
      }
    },
    "creditorAgent": {
      "financialInstitutionId": {
        "bic": "CHASUS33"
      }
    },
    "creditor": {
      "creditorAccount": {
        "accountId": "0070103277",
        "accountType": "BDA"
      }
    },
    "remittanceInformation": {
      "unstructuredInformation": [
        "Payment for container shipment"
      ]
    }
  }
}

Kinexys Digital Payments endToEndId details request

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

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

Example request using endToEndId
Curl
curl --request GET \ --url https://api-mock.payments.jpmorgan.com/tsapi/v1/payments?endToEndId=202E092v021D35E4' \ --header 'Accept: application/json'

Confirm endToEndId response

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

Example response using endToEndId
Json
{
  "paymentStatus": {
    "createDateTime": "2023-06-10T00:00:01.000",
    "status": "PENDING"
  },
  "payments": {
    "paymentIdentifiers": {
      "endToEndId": "202E092v021D35E4"
    },
    "requestedExecutionDate": "2023-06-10",
    "paymentCurrency": "USD",
    "paymentAmount": 6500,
    "transferType": "CREDIT",
    "paymentType": "BLOCKCHAIN",
    "debtor": {
      "debtorAccount": {
        "accountId": "8830699900",
        "accountType": "DDA"
      }
    },
    "debtorAgent": {
      "financialInstitutionId": {
        "bic": "CHASSGSG"
      }
    },
    "creditorAgent": {
      "financialInstitutionId": {
        "bic": "CHASUS33"
      }
    },
    "creditor": {
      "creditorName": "John Hodler",
      "creditorAccount": {
        "accountId": "0070103277",
        "accountType": "BDA"
      }
    },
    "remittanceInformation": {
      "unstructuredInformation": [
        "Payment for container shipment"
      ]
    }
  },
  "firmRootId": "98275a2d-1e88-beed-6938-0521a7e0oinc"
}

Connect to the Global Payments API.

Next Steps

Review our Resources page.