Initiate a JPM Coin System deposit request (DDA to BDA)
In this tutorial, you will learn how to use the Global Payments API to initiate a JPM Coin System deposit to fund a Blockchain Deposit Account. By the end of this tutorial, you will know how to:
- Create a well-formed JPM Coin System deposit request payload.
- Interpret the values in a successful response.
Before you begin
To initiate a JPM Coin System 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 JPM Coin System transaction.
Create and send a JPM Coin System 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 JPM Coin System deposit request, with no optional fields included:
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": "202E092v021D35E4152" } } }'
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.
{
"endToEndId": "202E092v021D35E4152",
"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.
JPM Coin System deposit request webhooks
Transaction status responses for your JPM Coin System deposit request are provided through webhooks.
{
"callbacks": [
{
"endToEndId": "202E092v021D35E4152",
"createDateTime": "2033-06-10T09:04:29.166Z",
"paymentStatus": "COMPLETED",
"firmRootId": " 98275a2d-1e88-beed-6938-0521a7e0oinc "
}
]
}
The JPM Coin System supports multiple response types, including PENDING, PENDING_POSTING, COMPLETED, and REJECTED. For more information, see Response types.
Related
Connect to the Global Payments API.
Next steps
- Initiate a JPM Coin System Payment.
- Initiate a JPM Coin System Payment Status Inquiry.