Virtual Accounts - setup

Get your integration ready before creating your first virtual account.

High Level - Integration Steps

  1. Complete the Prerequisites below.
  2. Onboard an end customer.
  3. Link an external wallet address (required for the auto-convert Virtual Accounts).
  4. Retrieve virtual accounts.
  5. Manage virtual accounts.

Pre-requisites

  1. Work with zerohash to determine your onboarding method:
    1. zerohash-managed KYC: embed a zerohash-managed KYC SDK (docs here)
    2. Reliance: choose your own KYC/KYB provider, implement their tech, and submit the result to zerohash via API (POST /participants/customers/new for individuals, POST/participants/entity/new for businesses)

Approval needed

The Reliance onboarding method requires approval by zerohash's Compliance team. Consult your zerohash representative to begin the review process.

  1. In the Client Portal, create an API key with the "Virtual Account" permission enabled for Read and Write.
  2. Provide zerohash with your callback URL so we can configure your Platform to listen to the following webhook events:
    1. Participants: for End customer status updates
    2. External Account: for external account status updates
      1. This is mostly relevant auto-convert Virtual Accounts, where the destination blockchain wallet address is considered an External Account.
    3. Virtual Accounts: for dedicated virtual account status updates



Did this page help you?