Depositing (Wire Transfer)

Request a fiat deposit via API.

Now it's time to create your first deposit.

Step 1: Create a deposit

Start by creating a POST request to the /deposits endpoint, indicating the destination address on-chain and the the identity of the entity executing the deposit. This identity will be verified upon reception of funds, to ensure it matches the underlying bank transaction.

Request
Response
Request
POST /deposits
{
"amount": "12",
"currency": "USD",
"identityId": "{{identityId}}",
"blockchainAddress": "0x6257EaCbB030ed1B33d11Aa841B2511B1B444937",
"transferInformation": {
"transferType": "wire"
}
}
Response
POST /deposits
{
"id": "ea5894d2-2657-424a-906e-0f9c345ab48b",
"identityId": "e65dde2c-4379-42c7-a665-3f476cebb691",
"amount": "11",
"currency": "USD",
"blockchainAddress": "0xF2A511240E0D6b7E9683Ff979b4C4Afb9d3fE2E9",
"message": null,
"status": "waiting",
"fundsTransferDetails": null,
"reference": null,
"transferInformation": {
"transferType": "wire",
},
"createdAt": "2020-02-19T11:15:08.144Z",
"updatedAt": "2020-02-19T11:15:08.144Z"
}

Step 2: GET deposit reference

In a few moments the custodial partner should update the request. You can check the new status by making a GET request to the /deposits endpoint.

Request
Response
Request
GET /deposits/:id
// Request body:
GET {hostname}:{port}/deposits/b22d80d9-0e14-4e4f-8101-881dd7138bc5
Response
GET /deposits/b22d80d9-0e14-4e4f-8101-881dd7138bc5
{
"id": "ea5894d2-2657-424a-906e-0f9c345ab48b",
"identityId": "e65dde2c-4379-42c7-a665-3f476cebb691",
"amount": "11",
"currency": "USD",
"blockchainAddress": "0xF2A511240E0D6b7E9683Ff979b4C4Afb9d3fE2E9",
"message": null,
"status": "waiting",
"fundsTransferDetails": null,
"reference": 'ASF3BG',
"transferInformation": {
"transferType": "wire",
},
"createdAt": "2020-02-19T11:15:08.144Z",
"updatedAt": "2020-02-19T11:15:08.144Z"
}

Try querying again in a few moments for the custodial partner to return the details and include a reference value, at which point you can wire the funds directly via your bank.

Step 3: Deposit fiat using provided reference

Using the selected transfer-method and the routingNumber and reference code returned by the custodian, simply transfer funds to the custodian's bank account. Bear in mind that wire transfers can take up to a few working days to clear through the traditional banking system.

Once the deposit is processed and confirmed, the custodian will automatically forward the confirmation to Public Mint. This will programmatically trigger the minting of tokenized fiat and send the funds to the recipient user's wallet address on the Public Mint blockchain.

Congratulations! Your fiat is now available for you to transact all across the blockchain!