Initiate a Kinexys Digital Payments deposit request (DDA to BDA)

In this tutorial, you will learn how to use the Global Payments API to initiate a Kinexys Digital Payments deposit to fund a Blockchain Deposit Account. By the end of this tutorial, you will know how to:

Create a well-formed Kinexys Digital Payments deposit request payload.
Interpret the values in a successful response.

Before you begin

To initiate a Kinexys Digital Payments deposit, 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 Account (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.

Create and send a Kinexys Digital Payments deposit request payload

Request payloads for the Global Payments API have optional and required fields. The full request payload is sent using a POST HTTP request.

The following example shows the minimum required payload for a Kinexys Digital Payments deposit request, with no optional fields included:

Kinexys Digital Payments Deposit (DDA to BDA)

Curl

curl --request POST \   --url https://api-mock.payments.jpmorgan.com/tsapi/v1/tsapi/v1/payments \   --header 'Accept: application/json' \   --header 'Content-Type: application/json' \   --data '{   "payments": {     "requestedExecutionDate": "2033-06-10",     "debtor": {       "debtorAccount": {         "accountId": "8830699900",         "accountType": "DDA"       }     },     "creditor": {       "creditorAccount": {         "accountId": "0070103277",         "accountType": "BDA"       }     },     "debtorAgent": {       "financialInstitutionId": {         "bic": "CHASSGSG"       }     },     "paymentType": "BLOCKCHAIN",     "transferType": "CREDIT",     "creditorAgent": {       "financialInstitutionId": {         "bic": "CHASUS33"       }     },     "paymentAmount": 6500,     "paymentCurrency": "USD",     "paymentIdentifiers": {       "endToEndId": "202E092v021D35E4"     }   } }'

Confirm response

You should receive a successful response containing a firmRootId and an endToEndId. These values are used to retrieve the status of your request.

Kinexys Digital Payments Deposit Confirmation Response

Json

{
  "endToEndId": "202E092v021D35E4",
  "firmRootId": "98275a2d-1e88-beed-6938-0521a7e0oinc"
}

There are a few error responses you may encounter. For more information about error codes, see the error codes section.

Kinexys Digital Payments deposit request webhooks

Transaction status responses for your Kinexys Digital Payments deposit request are provided through webhooks.

Kinexys Digital Payments Deposit Webhook

Json

{
  "callbacks": [
    {
      "endToEndId": "202E092v021D35E4",
      "createDateTime": "2033-06-10T09:04:29.166Z",
      "paymentStatus": "COMPLETED",
      "firmRootId": " 98275a2d-1e88-beed-6938-0521a7e0oinc "
    }
  ]
}

The Kinexys Digital Payments supports multiple response types, including PENDING, PENDING_POSTING, COMPLETED, and REJECTED. For more information, see Response types.

Connect to the Global Payments API.

Next steps

Initiate a Kinexys Digital Payments Payment.
Initiate a Kinexys Digital Payments Payment Status Inquiry.