Search…
⌃K
Links

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

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.

Example Call

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

Example Call

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

Example Call

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"
}]
}