Distributor API Integration
Key Terms
Distributor
The primary business entity integrating with Interlace’s API to facilitate card issuance for their downstream clients.
Master Merchant
Master merchants are the distributor’s business clients. They are typically companies or corporate entities and they use the distributor’s API to issue cards to their own customers.
-
Registration and Verification
- Master merchants are required to register, open an account, and complete KYB verification, either online at https://www.interlace.money/sign-up or by submitting the necessary information offline through their distributor.
- Distributors may be authorized by their master merchants to submit this information on their behalf via the Interlace platform.
-
Account Setup
- Each master merchant will be provisioned with:
- A CryptoConnect Wallet for managing on-chain deposits (crypto transactions).
- An Infinity Account for managing and settling fiat funds.
- Each master merchant will be provisioned with:
-
Access and Interaction
- Master merchants do not typically have direct access to Interlace’s dashboard.
- Instead, they operate through the distributor, which manages their integration, credentials, and related services on their behalf
Sub-Merchant and Cardholder
- Sub-Merchant (Gateway Model):
- Onboarded by master merchants as downstream clients.
- Can be businesses or individuals.
- Each sub-merchant is provisioned with:
- CryptoConnect Wallet: For receiving crypto-based deposits.
- Infinity Account: For managing fiat funds converted or transferred from the CryptoConnect Wallet.
- Cardholder (MoR Model):
- End customers of the merchant
- Typically individuals or authorized users of businesses.
Account Structure
Below is an overview of how accounts are structured within the Interlace ecosystem:
Fund Flow Management
-
Sub-Merchant to Own Infinity Account
- Sub-merchants (e.g. Sub-Merchant A1) can transfer funds from their CryptoConnect Wallet to their own Infinity Account using the Transfer API.
- Example Use Case: A sub-merchant converts crypto-based funds to fiat for business operations or settlements.
- Sub-merchants (e.g. Sub-Merchant A1) can transfer funds from their CryptoConnect Wallet to their own Infinity Account using the Transfer API.
-
Sub-Merchant to Master Merchant
- Master merchants (e.g. Master Merchant A) can pull funds from a Sub-Merchant's Infinity Account (e.g., Sub-Merchant A1) into their Master Merchant’s Infinity Account using the same Transfer API.
- Example Use Case: A master merchant consolidates funds from its sub-merchants for centralized treasury management or settlements.
- Master merchants (e.g. Master Merchant A) can pull funds from a Sub-Merchant's Infinity Account (e.g., Sub-Merchant A1) into their Master Merchant’s Infinity Account using the same Transfer API.
-
Master Merchant to Sub-Merchant
- Master merchants (e.g. Master Merchant A) can transfer funds from their Infinity Account to any other sub-merchant’s Infinity Account (e.g. Sub-Merchant B1) using the Transfer API.
- Example Use Case: A master merchant redistributes funds to its sub-merchants for payouts, funding, or operational needs.
- Master merchants (e.g. Master Merchant A) can transfer funds from their Infinity Account to any other sub-merchant’s Infinity Account (e.g. Sub-Merchant B1) using the Transfer API.
API Workflow
This section outlines the integration process of Interlace's API, to cover the roles of distributors, master merchants, and sub-merchants.
Distributor Setup
-
Facilitate Master Merchant Registration
- Distributors should guide their master merchants through the registration process and submission of KYB information via https://www.interlace.money/sign-up.
-
Request Production Credentials
- Once KYB is approved, distributors or master merchants can request production environment credentials by contacting Interlace’s Customer Support Team.
- Distributors are authorized to manage production credentials on behalf of their master merchants.
-
Configure Webhooks and Integration Settings
- Configure the necessary settings, such as webhook URLs, for each master merchant.
- Note: Each master merchant is issued a unique set of credentials for production access.
Master Merchant Setup
-
Registration and KYB Verification
- Master merchants are required to register, open an account, and complete KYB verification, either online at https://www.interlace.money/sign-up or by submitting the necessary information offline through their distributor.
- Distributors may be authorized to handle the registration and KYB submission on behalf of their master merchants through Interlace’s platform.
-
Obtain Production Credentials
- Once KYB is approved, the master merchant (or their distributor) can request production environment credentials by contacting Interlace’s Customer Support Team.
-
Webhook Configuration
- Set up webhooks to enable seamless communication between Interlace and the merchant’s system.
Sub-Merchant Setup
-
Create Sub-Merchant Account
- Use the Create Account API (v1) to register sub-merchants under the master merchant.
-
Submit Sub-Merchant KYC
- KYC information for sub-merchants must be submitted for verification via the Submit Account KYC API (v2).
- Endpoint (v2):
/open-api/v2/accounts/{id}/kyc
- Submission Methods:
- Use a SumSub reusable token to share KYC information.
- Submit KYC information directly through Interlace’s Account API.
- Endpoint (v2):
- Interlace will review and approve the KYC submission.
- KYC information for sub-merchants must be submitted for verification via the Submit Account KYC API (v2).
-
Initialize Sub-Merchant Accounts
- Once KYC is approved, initialize the sub-merchant’s accounts with the Initialization API (v2).
- Endpoint (v2):
/open-api/v2/accounts/{id}/initialization
- Automatically creates:
- CryptoConnect Wallet (for crypto settlement).
- Infinity Account (for fiat settlement).
- Webhook Notification: Interlace will send a webhook with the UUIDs of the sub-merchant’s CryptoConnect Wallet and Infinity Account.
- Endpoint (v2):
- Once KYC is approved, initialize the sub-merchant’s accounts with the Initialization API (v2).
-
Generate Blockchain Wallet Address
- Use the CryptoConnect Wallet ID and the Create Wallet Address API (v2) to create a blockchain wallet address for the sub-merchant.
- Endpoint (v2):
/open-api/v2/CryptoConnect/wallets/{id}/addresses
.
- Endpoint (v2):
- Use the CryptoConnect Wallet ID and the Create Wallet Address API (v2) to create a blockchain wallet address for the sub-merchant.
-
Fund Sub-Merchant Infinity Account (if required)
- Transfer funds from the CryptoConnect Wallet to the sub-merchant’s Infinity Account using the Transfer Funds API (v1).
- Endpoint (v1):
/open-api/v1/asset/transfers
.
- Endpoint (v1):
- Transfer funds from the CryptoConnect Wallet to the sub-merchant’s Infinity Account using the Transfer Funds API (v1).
Additional Notes on Sub-Merchant Onboarding
- Online Setup:
- Only sub-merchants who are individuals can be onboarded online.
- Business Sub-Merchant Setup:
- Onboarding business sub-merchants requires offline submission and processing. Please contact your Relationship Manager for assistance.
Cardholder Setup
*Applicable only for US Apple Pay BIN card issuance
Guide for US Apple Pay Card BIN Integration
Support and Assistance
For any questions or technical issues during the integration process:
- Contact your Interlace Relationship Manager for business-related support.
- Reach out to Interlace Technical Support Team for integration and development queries.
Updated 22 days ago