Gateway Mode Card Issuing

Guidance for Card Issuing in Gateway Mode: Account Structure and API Workflow

This document provides guidance for card issuing in gateway mode, focusing on the account structure setup for master merchants and sub-merchants, as well as the API integration workflow. It is designed to help API clients with card issuance needs understand the process in a clear and professional manner.

Definitions

  1. Master Merchant:

The primary client using gateway mode to integrate with the card issuing API.

The master merchant has its own Cryptoconnect Wallet and Infinity Account. To begin, the master merchant must register, open an account, and pass KYB verification at https://www.interlace.money/sign-up.

  1. Sub-Merchant:

A lower-tier client onboarded by the master merchant.

Sub-merchants can be either individual customers or businesses. Each sub-merchant has:

  • Cryptoconnect Wallet: Used for receiving on-chain deposits (crypto settlement).
  • Infinity Account: Used for receiving funds transferred from the Cryptoconnect Wallet (fiat settlement).

Note

  • Currently, only individual customers can complete the setup process online.
  • If you need to onboard businesses as sub-merchants, please contact your Relationship Manager for offline submission and processing.

Terminology:

  • Master Merchant Wallet: The Cryptoconnect Wallet of the master merchant.
  • Sub-Merchant Wallet: The Cryptoconnect Wallet of a sub-merchant.
  • Master Merchant Infinity Account: The Infinity Account of the master merchant.
  • Sub-Merchant Infinity Account: The Infinity Account of a sub-merchant.

Account Structure

Below is a diagram illustrating the account structure:

Key Points:

  1. Account Independence:

    • Each sub-merchant has its own Cryptoconnect Wallet and Infinity Account.
    • The master merchant's accounts (wallet and Infinity Account) do not interact with the sub-merchants' accounts, except in cases where transaction fees are collected.
  2. Security and Fund Segregation:

    • Sub-merchants' funds are completely independent to ensure security and protect client assets. There is no direct interaction between sub-merchants' accounts.

API Workflow

The following is the step-by-step API workflow for setting up the master merchant and sub-merchants:

Master Merchant Setup

  1. Registration and KYB Verification:

    • The master merchant must register at https://www.interlace.money/sign-up and submit KYB information.
    • Upon approval, please contact our tech support team for the production environment credentials and configure necessary settings (e.g., webhook URL).

Sub-Merchant Setup

  1. Create Sub-Merchant Account:
    Use the Create Account API to create a sub-merchant account.

    • Endpoint: Create Account (v1)
    • Purpose: Register a sub-merchant under the master merchant.
  2. Submit Sub-Merchant KYC Information:
    Submit the sub-merchant's KYC information for verification.

    • Endpoint: Submit Account KYC (v2)
    • Options:
      • Share KYC information using a SumSub reusable token (SumSub Account KYC).
      • Submit KYC information directly through the Account API.
    • Interlace Review: Interlace will handle the KYC review process.
  3. Initialize Sub-Merchant Accounts:
    Once KYC is approved, initialize the sub-merchant’s accounts.

    • Endpoint: Initialization (v2)
    • Purpose: Automatically create the sub-merchant's Cryptoconnect Wallet and Infinity Account.
    • Webhook Notification: Upon successful initialization, Interlace will send a webhook containing the UUIDs of the sub-merchant's Cryptoconnect Wallet.
  4. Create Blockchain Wallet Address:
    Use the Cryptoconnect Wallet ID from the initialization step to generate a blockchain wallet address for the sub-merchant.

  5. Fund Infinity Account:
    If required, fund the sub-merchant's Infinity Account by transferring funds from the Cryptoconnect Wallet.


Example API Workflow Sequence

  1. Master Merchant Setup:

    • Register and pass KYB verification.
  2. Sub-Merchant Onboarding:

    • Create Sub-Merchant Account → Submit KYC Information → Initialize Accounts → Create Wallet Address → Fund Infinity Account (if needed).

For further assistance, feel free to reach out to our Tech Support team.