Card Issuance Integration for MoR Mode (Consumer Use)

Before starting the integration, confirm your operating model: MoR (Merchant of Record) or Gateway Mode. Refer to the official documentation for guidance: Determine Your Integration Model.

Project Background

In this model, licensed digital wallets or similar businesses issue cards directly to their customers. The service provider operates as the Merchant of Record (MoR).

Use Case Example

A licensed digital wallet issues prepaid cards to their customers for online and in-store purchases.

Workflow

1. Master-Merchant Account Registration (Offline Process)

The enterprise (master merchant) must be registered before any cardholder or card creation can take place. This step is completed offline.

2. Deposit Fiat/Crypto to Infinity Account

All card-related fees will be deducted from the Infinity Account. Therefore, ensure your Infinity Account is funded directly, either via fiat or cryptocurrency. Note that the Infinity Account only supports USD; any crypto deposits will be converted to USD before being credited.

2.1 Deposit Fiat to Infinity Account

If funding your Infinity Account with fiat, complete the transfer via the merchant portal at https://www.interlace.money/.

2.2 Deposit Crypto to Infinity Account

If funding your Infinity Account with cryptocurrency, you must first create a wallet and obtain a receiving address. Deposited crypto (e.g., USDC or USDT) will be converted to USD before being credited to your Infinity Account.

1. Step 1: Create a new wallet
   Use the "Create a wallet" API to create a new wallet.

   • Endpoint: Create a wallet (v2)
   • You may assign a nickname to the wallet.

2. Step 2: Get a wallet address
   Use the "Get a wallet" API to fetch wallet details, including balance and available address.

   • Endpoint: Get a wallet (v2)
   • Note: walletId must be included in the request.

3. Step 3 (Optional): Generate an additional address
   If no address is available, or if you need an address on a different blockchain, use the "Create an address" API to generate a new one.

   • Endpoint: Create a blockchain address (v2)

4. Step 4: Deposit crypto to Infinity Account
   After receiving the deposit webhook notification from Interlace, use the "Create a transfer" API to move USDC or USDT into your Infinity Account. The system will convert the crypto to USD before the funds are credited.

   • Endpoint: Create a transfer (v1)
   • Body parameters: "source": "CRYPTO ASSETS" "destination": "INFINITY ACCOUNT"
   • For the type field, use the default value. For the id field, enter the master account ID. If left blank, the system will use the master account ID by default.

3. Create Cardholder

Cardholder creation is mandatory for all card issuance.

• Endpoint: Create a cardholder (v2)
• Body parameter: "programType": "CONSUMER USE - MOR"

Notes:

• After the cardholder is created, approval from the issuing bank is required before issuing a card.
• To stay informed about cardholder status updates, please subscribe to our webhook. This will ensure you receive real-time notifications whenever a status change occurs.
• OTP (One-Time Password) will be sent to the cardholder for identity verification during sensitive operations such as card activation or transaction authorization.

4. Create Card

First, decide which type of card you want to issue: prepaid card or budget card.

4.1 Create a Prepaid Card

Use the "Create Infinity Card" API to directly create a prepaid card.

• Endpoint: Create Infinity Card (v2)
• Body parameter: "type": "PrepaidCard"

Balance Management:The balance of a prepaid card is controlled by transferring funds between the Infinity Account and the card.

• Transfer funds into the card: Use the Infinity Card Transfer In API (v1)
• Transfer funds out of the card: Use the Infinity Card Transfer Out API (v1)

4.2 Create a Budget Card

To create a budget card, you must first set up a budget using the "Budget" API, and then create cards under that budget with the "Create Infinity Card" API.

1. Step 1: Create a Budget

   • Endpoint: Create a budget (v1)

2. Step 2: Create a Budget Card

   • Endpoint: Create Infinity Card (v2)
   • Body parameter: "type": "BudgetCard"
   • Required: Include the budgetId in the request body when creating a budget card.

Balance & Spending Control:

• The balance of a budget is managed through transfers between the Infinity Account and the budget.

  • Increase the budget balance API (v1) – to allocate funds from the Infinity Account to the budget.
  • Decrease the budget balance API (v1) – to return funds from the budget back to the Infinity Account.

• A budget card itself does not hold funds. Its available spending is strictly tied to the budget balance and governed by the velocity control (spending limits) configured for that budget.

  • Endpoint: Velocity Control (v1)

Notes:

• Virtual and physical cards must be created separately. Once issued as a virtual card, it cannot be converted into a physical card. For details on physical card issuance, see Issuing Physical Cards.
• This step can only be performed after the cardholder creation has been approved.