Skip to main content

​
How to retrieve the next page records from the Retrieve List API ?

The Retrieve List APIs respond with total number of records in the response. You can use paginationLimit & paginationOffset in the request payload to paginate through the results.

​
Does Zodia notify clients of any events?

Throughout any request or transaction lifecycle, Zodia generates a variety of status change events such as incoming transfers, outgoing transfers, and wallet creation. Zodia can assist you in subscribing to relevant events so that you are informed when action is required on your end. Zodia currently support two types of subscriptions,
  • REST Webhook
  • JMS

​
Does Zodia support working with testnets?

Yes, you can use Zodia’s sandbox environment to test with all supported testnets, such as Ethereum Testnet (Sepolia), Stellar Testnet, and Bitcoin Testnet.

​
What is the currency unit referenced in the APIs?

The units used in the API are the smallest denomination for a currency i.e., Satoshi (Bitcoin), Wei (Ethereum), and Litoshi (Litecoin).

​
What is the currency unit for the fee element in the transaction details?

The currency unit for the fee for all L2 coins will be in its native currency, such as ETH for USDC transfers.

​
How to check available wallet balance?

Please use Custody -> Retrieve Wallet API to find out the available balance of a specific wallet.

​
How to resolve Signature verification failure error?

Please ensure to check below,
  • You are using the correct company private key for signing the request.
  • The payload used in request body is exactly matches json string used for generating the signature. (including the spaces or new lines)
  • You are using the full path of the API (encoded) in the : separated string format

​
What steps are usually followed when creating a custody wallet?

  1. Get the serviceId & template (i.e. 0x0013-001) using List of Products
  2. [Maker] Create service request using Create Service Request
  3. [Maker] Submit the service request using Submit Service Request
  4. [Maker] Confirm the request (2-step process)
  1. [Checker] Approve the request (2-step process)
  1. With the service request id, check the status of the request using List Service Requests
  2. With the service request id, check the audit trail of the request using Audit Trial
  3. Get the details of the created wallet using Get Wallets
  4. Generate wallet address using Generate Wallet Address

​
What steps are usually followed when creating a beneficiary & whitelist an external address?

  1. Get the serviceId & template (i.e. 0x0007-004) using List of Products
  2. [Maker] Create service request using Create Service Request
  3. [Maker] Submit the service request using Submit Service Request
  4. [Maker] Confirm the request (2 step process)
  1. [Checker] Approve the request (2 step process)
  1. With the service request id, check the status of the request using List Service Requests
  2. Get the beneficiary details using the entityId List Beneficiaries
  3. Adding an address to the beneficiary (Whitelisting an external address) by getting the serviceId & template (i.e. 0x0007-007) using List of Products
  4. [Maker] Create service request using the external address & beneficiaryId (i.e. entityId generated above) Create Service Request
  5. [Maker] Submit the service request using Submit Service Request
  6. [Maker] Confirm the request (2 step process)
  1. [Checker] Approve the request (2 step process)
  1. With the service request id, check the status of the request using List Service Requests
  2. Confirm address has been added for the beneficiary using Whitelisted Addresses

​
Is it possible to create two beneficiaries with the same name?

Yes, an individual or a company can have the same name. Another field needs to be different though to ensure the combinaison is unique (can be the geographice address or the registration number for example).

​
Is it possible to whitelist the same wallet address with the same beneficairy?

No, it is not possible to whitelist the same wallet address twice with the same beneficiary. The beneficiary (individual or organisation) must be different.

​
What does the cryptoAddressIds field refer to?

cryptoAddressIds refers to the id of the whitelisted address. When you whitelist an address using (0x0007-007) the response of /create will give you the id (entityId) for that request.