Customers

Understanding customer management, properties, and wallet addresses in the SDigital2 API

Back to Core Concepts

Overview

Customers represent the end-users who will be sending or receiving cryptocurrency through your integration.

Customer Management

Important: Customers are manually onboarded to SDigital2 by our team. You cannot create customers directly through the API.

Customer Onboarding Process:

Speak to the SDigital2 team about your customer onboarding requirements
The SDigital2 team will add customers to your organization
Once added, customers will automatically appear in your API customer list endpoints
Each customer receives unique wallet addresses across supported blockchain networks

Customer Properties

Core Information:

ID: Unique UUID identifier for API operations
Name: Customer's display name
Type: Either INDIVIDUAL or BUSINESS
Created/Updated: Timestamps for tracking

Wallet Information:

Wallet Addresses: Unique deposit addresses for each supported blockchain
Balances: Real-time token balances across all chains
Multi-Chain Support: Automatic address generation for all supported networks

Supported Blockchain Networks

Ethereum (ETHEREUM)
Polygon (POLYGON)
Base (BASE)

Example Customer Response

{
  "id": "774f7a53-fd45-4634-9548-eb37c9554137",
  "name": "John Doe",
  "type": "INDIVIDUAL",
  "createdAt": "2025-09-08T07:01:04.093Z",
  "updatedAt": "2025-09-08T07:01:04.084Z",
  "walletAddresses": [
    {
      "chain": "BASE",
      "walletAddress": "0x2fc4512d5859226cf0bf61fbbbdb5444fda60053",
      "balances": [
        {
          "currency": "USDC",
          "amount": "215.462157",
          "updatedAt": "2025-09-12T22:56:00.566Z"
        }
      ]
    },
    {
      "chain": "ETHEREUM",
      "walletAddress": "0xba1c64834804eac723776aa6addf216d307eb336",
      "balances": [
        {
          "currency": "USDC",
          "amount": "398.770344",
          "updatedAt": "2025-09-12T22:56:00.648Z"
        },
        {
          "currency": "USDT",
          "amount": "0",
          "updatedAt": "2025-09-12T22:56:00.648Z"
        }
      ]
    },
    {
      "chain": "POLYGON",
      "walletAddress": "0xbc87a12b0e9570bb5472d6066f220db7e98b709e",
      "balances": [
        {
          "currency": "USDC",
          "amount": "0",
          "updatedAt": "2025-09-12T22:56:00.594Z"
        },
        {
          "currency": "USDT",
          "amount": "0",
          "updatedAt": "2025-09-12T22:56:00.594Z"
        }
      ]
    }
  ]
}