Deposits (deprecated)
These endpoints are deprecated and will be discontinued by November 1st. Please make sure you migrate your implementation to the new deposits flow.
To initiate a deposit, create a
deposit
object via the /deposits
endpoint. If you want to create an ACH type deposit, you need to have created at least one transfer method in order to make a deposit.ENDPOINTS
POST /deposits
GET /deposits/:id
GET /deposits
The
deposit
object represents a request for depositing fiat into the blockchain. You can create or retrieve an identityId
's deposits via request to the API. Or, if you manage multiple identities in the network, you can also retrieve a list of deposits for all of them.Deposits are identified by a unique, random
id
, and relate to a user's identityId
DEPOSITS OBJECT
{
"id": "3305af3a-e3c8-4f73-a46b-58c0d6376825",
"identityId": "971c3241-9876-471e-b0b3-40040893efd0",
"amount": "12",
"currency": "USD",
"blockchainAddress": "0x359f194ce353b1415abff5fcb07baf59f0bda0de",
"transferMethodInformation": {
"transferType": "wire"
},
"status": "pending",
"reference": null,
"createdAt": "2021-02-17T18:02:50.365Z",
"updatedAt": "2021-02-17T18:02:50.365Z"
}
post
[ENVIRONMENT HOSTNAME]
/deposits
POST /deposits
Note: The
transferInformation
object needs specific information depending on the kind of deposit you intend to create. In the example bellow, you can find the information necessary to create all the deposit types.
Request
Curl
Response
POST [ENVIRONMENT HOSTNAME]/deposits
// BODY for Wire deposits
{
"amount": "11",
"currency": "USD",
"identityId": "{{identityId}}",
"blockchainAddress": "{{identityId}}",
"transferInformation": {
"transferType": "wire"
}
}
// BODY for International Wire deposits
{
"amount": "11",
"currency": "USD",
"identityId": "{{identityId}}",
"blockchainAddress": "{{blockchainAddress}}",
"transferInformation": {
"transferType": "internationalWire"
}
}
// BODY for USDC deposits
{
"amount": "11",
"currency": "USD",
"identityId": "{{identityId}}",
"blockchainAddress": "{{blockchainAddress}}",
"transferInformation": {
"transferType": "scUsdc"
}
}
curl -X POST \
[ENVIRONMENT HOSTNAME]/deposits \
-H 'Content-Type: application/json' \
-H 'apikey: {INSERT API KEY HERE}' \
-d '{
"amount": "12",
"currency": "USD",
"identityId": "e65dde2c-4379-42c7-a665-3f476cebb691",
"blockchainAddress": "0xA4597E696a55fD76430945e0940DA17c72337ccC",
"transferInformation": {
"transferType": "wire"
}
}'
{
"id": "3305af3a-e3c8-4f73-a46b-58c0d6376825",
"identityId": "971c3241-9876-471e-b0b3-40040893efd0",
"amount": "12",
"currency": "USD",
"blockchainAddress": "0x359f194ce353b1415abff5fcb07baf59f0bda0de",
"transferMethodInformation": {
"transferType": "wire"
},
"status": "waiting",
"reference": null,
"createdAt": "2021-02-17T18:02:50.365Z",
"updatedAt": "2021-02-17T18:02:50.365Z"
}
On the Sandbox environment, you can use the settle deposit endpoint to simulate and settle the deposit request you created.
On the Sandbox environment, you can use the approve KYC endpoint to simulate and approve the identity you created.
get
[ENVIRONMENT HOSTNAME]
/deposits/:id
GET /deposits/:id
Request
Curl
Response
GET [ENVIRONMENT HOSTNAME]/deposits/b22d80d9-0e14-4e4f-8101-881dd7138bc5
curl -X GET \
[ENVIRONMENT HOSTNAME]/deposits/7b6bbb41-b0e0-4058-b59e-ea3181f854ec \
{
"id": "3305af3a-e3c8-4f73-a46b-58c0d6376825",
"identityId": "971c3241-9876-471e-b0b3-40040893efd0",
"amount": "12",
"currency": "USD",
"blockchainAddress": "0x359f194ce353b1415abff5fcb07baf59f0bda0de",
"transferMethodInformation": {
"transferType": "wire"
},
"status": "waiting",
"reference": null,
"createdAt": "2021-02-17T18:02:50.365Z",
"updatedAt": "2021-02-17T18:02:50.365Z"
}
get
[ENVIRONMENT HOSTNAME]
/deposits
GET /deposits
Request
Curl
Response
GET [ENVIRONMENT HOSTNAME]/deposits
// PAGINATED
GET [ENVIRONMENT HOSTNAME]/deposits?page[number]=1&page[size]=1
curl -X GET \
[ENVIRONMENT HOSTNAME]/deposits/7b6bbb41-b0e0-4058-b59e-ea3181f854ec \
-H 'apikey: {INSERT API KEY HERE}'
{
"total": 1,
"data": [
{
"id": "3305af3a-e3c8-4f73-a46b-58c0d6376825",
"identityId": "971c3241-9876-471e-b0b3-40040893efd0",
"amount": "12",
"currency": "USD",
"blockchainAddress": "0x359f194ce353b1415abff5fcb07baf59f0bda0de",
"transferMethodInformation": {
"transferType": "wire"
},
"status": "waiting",
"reference": null,
"createdAt": "2021-02-17T18:02:50.365Z",
"updatedAt": "2021-02-17T18:02:50.365Z"
}]
}
Last modified 1yr ago