Skip to main content
Beta version available

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

Initiate a JPM Coin System payment request

In this tutorial, you will learn how to use the Global Payments API to initiate a JPM Coin System payment request from a Blockchain Deposit Account (BDA) to another BDA or a Demand Deposit Account (DDA). By the end of this tutorial, you will know how to:

  • Create a well-formed JPM Coin System payment request payload from a BDA to BDA.
  • Create a well-formed JPM Coin System payment request payload from a BDA to DDA from the same or different entity.
  • Interpret the values in a successful response.

Before you begin

To initiate a JPM Coin System payment, 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 JPM Coin System 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 JPM Coin System payment request payload

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

The following examples show the minimum required payload for a JPM Coin System payment request, with no optional fields included.

JPM Coin System payment (BDA to BDA)

Use the following payload example to initiate a payment to move funds between two Blockchain Deposit Accounts (BDAs). These BDAs can belong to the same or different entity.

JPM Coin System payment (BDA to BDA)
Curl
curl --location 'https://api-mock-payments.jpmorgan.com/tsapi/v1/payments' \ --header 'Content-Type: application/json' \ --data '{     "payments": {         "paymentIdentifiers": {             "endToEndId": "COIN20230125_081"         },         "requestedExecutionDate": "2022-09-01",         "paymentCurrency": "USD",         "paymentAmount": 1.01,         "transferType": "CREDIT",         "paymentType": "BLOCKCHAIN",         "debtor": {             "debtorAccount": {                 "accountId": "940091064",                 "accountType": "BDA"             }         },         "debtorAgent": {             "financialInstitutionId": {                 "bic": "CHASUS33"             }         },         "creditorAgent": {             "financialInstitutionId": {                 "bic": "CHASUS33"             }         },         "creditor": {             "creditorAccount": {                 "accountId": "80091097",                 "accountType": "BDA"             }         },         "remittanceInformation": {             "unstructuredInformation": [                 "unstructured-remittance-information-1"             ]         }     } }'

JPM Coin System payment (BDA to DDA)

Use the following payload example to initiate a payment to move funds from a Blockchain Deposit Account (BDA) to a Demand Deposit Account (DDA). The following are common Coin System payment combinations:

  • A payment moving funds from a linked BDA to a DDA. The BDA and DDA must belong to the same entity.
  • A payment moving funds from a non-linked BDA directly to a DDA. The BDA and DDA can belong to the same or a different entity.
JPM Coin System payment (BDA to DDA)
Curl
curl --location 'https://api-mock-payments.jpmorgan.com/tsapi/v1/payments' \ --header 'Content-Type: application/json' \ --data '{     "payments": {         "paymentIdentifiers": {             "endToEndId": "COIN20230125_083"         },         "requestedExecutionDate": "2022-09-01",         "paymentCurrency": "USD",         "paymentAmount": 1.01,         "transferType": "CREDIT",         "paymentType": "BLOCKCHAIN",         "debtor": {             "debtorAccount": {                 "accountId": "80091097",                 "accountType": "BDA"             }         },         "debtorAgent": {             "financialInstitutionId": {                 "bic": "CHASUS33"             }         },         "creditorAgent": {             "financialInstitutionId": {                 "bic": "CHASESM3"             }         },         "creditor": {             "creditorAccount": {                 "accountId": "73239505",                 "accountType": "DDA"             }         },         "remittanceInformation": {             "unstructuredInformation": [                 "unstructured-remittance-information-1"             ]         }     } }'

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.

JPM Coin System payment confirmation response
Json
{
  "paymentInitiationResponse": {
    "firmRootId": " 989a066e-2947-4fa9-9ec7-5d09b1917c11",
    "endToEndId": " COIN20230125_083"
  }
}

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

JPM Coin System request webhooks

Transaction status responses for your JPM Coin System payment request are provided through webhooks.

The JPM Coin System supports multiple response types, including PENDING, PENDING_POSTING, COMPLETED, and REJECTED. For more information, see Response types.

Next steps

Initiate a JPM Coin System Payment Status Inquiry.