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
  3. Decide whether you or zerohash will send email receipts to your end customers. zerohash has a regulatory obligation to ensure end customers receive email receipts for certain virtual account events, and offers this as a free service to simplify your integration. See in-depth guide here.



Did this page help you?