Customers

The Customers API lets you create managed accounts for your own business customers. Each customer gets their own wallets and transaction history under your platform umbrella — you retain full programmatic control while keeping each customer’s data isolated. This is the foundation of a B2B crypto-as-a-service product: you use the Yativo API on the backend, and your customers interact with your interface.

These are WaaS (wallet) customers — not card customers. If you are issuing crypto cards, your card holders are managed separately via the Card Issuer API. The two systems use different customer records and different endpoints. A customer enabled for cards is created through the card onboarding flow; a customer here is created with a single API call and gets crypto wallets immediately.

Type Definitions

interface Customer {
  customer_id: string;
  email: string;
  name?: string;
  phone?: string;
  metadata?: Record<string, string>;
  status: "active" | "suspended";
  created_at: string;
}

interface CreateCustomerRequest {
  email: string;
  name?: string;
  phone?: string;
  metadata?: Record<string, string>;
}

Create a Customer

POST /customers/create-customer

string

required

Customer’s email address. Used as the unique identifier for the customer.

string

Full name of the customer or business.

string

Customer’s phone number.

object

Arbitrary key-value pairs for storing your own reference data (e.g., your internal customer ID, account tier, etc.).

curl -X POST https://crypto-api.yativo.com/api/v1/customers/create-customer \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "name": "Acme Corp",
    "phone": "+14155551234",
    "metadata": {
      "internal_id": "cust-8821",
      "plan": "enterprise"
    }
  }'

const customer = await client.customers.create({
  email: 'customer@example.com',
  name: 'Acme Corp',
  phone: '+14155551234',
  metadata: {
    internal_id: 'cust-8821',
    plan: 'enterprise',
  },
});
console.log('Customer ID:', customer.id);

customer = client.customers.create(
    email='customer@example.com',
    name='Acme Corp',
    phone='+14155551234',
    metadata={
        'internal_id': 'cust-8821',
        'plan': 'enterprise',
    },
)
print('Customer ID:', customer['id'])

Response

{
  "id": "cust_01abc123",
  "email": "customer@example.com",
  "name": "Acme Corp",
  "phone": "+14155551234",
  "metadata": {
    "internal_id": "cust-8821",
    "plan": "enterprise"
  },
  "status": "active",
  "created_at": "2026-03-26T10:00:00Z"
}

Get Customers

POST /customers/get-customers Returns all customers under your platform account.

cURL

curl -X POST https://crypto-api.yativo.com/api/v1/customers/get-customers \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

{
  "customers": [
    {
      "id": "cust_01abc123",
      "email": "customer@example.com",
      "name": "Acme Corp",
      "status": "active",
      "created_at": "2026-03-26T10:00:00Z"
    },
    {
      "id": "cust_02def456",
      "email": "another@example.com",
      "name": "Beta Inc",
      "status": "active",
      "created_at": "2026-03-20T08:00:00Z"
    }
  ],
  "total": 2
}

Get Customer Transactions

POST /customers/get-customer-transactions Returns the full transaction history for a specific customer.

string

required

The ID of the customer to retrieve transactions for.

cURL

curl -X POST https://crypto-api.yativo.com/api/v1/customers/get-customer-transactions \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"customer_id": "cust_01abc123"}'

Response

{
  "customer_id": "cust_01abc123",
  "transactions": [
    {
      "transaction_id": "txn_01pqr456",
      "type": "withdrawal",
      "status": "completed",
      "amount": "100.00",
      "ticker": "USDC",
      "chain": "ethereum",
      "to_address": "0x9F8b3A2c1E4D7F6B5A4C3D2E1F0A9B8C7D6E5F4",
      "completed_at": "2026-03-26T10:07:30Z"
    },
    {
      "transaction_id": "txn_02stu789",
      "type": "deposit",
      "status": "completed",
      "amount": "500.00",
      "ticker": "USDC",
      "chain": "ethereum",
      "from_address": "0x1A2B3C4D5E6F7A8B9C0D1E2F3A4B5C6D7E8F9A0B",
      "completed_at": "2026-03-25T14:30:00Z"
    }
  ],
  "total": 2
}

Customer Wallets

After creating a customer, add wallets using the Assets API with the customer-specific endpoints:

# Add a wallet for a customer
curl -X POST https://crypto-api.yativo.com/api/v1/assets/add-customer-asset \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cust_01abc123",
    "chain": "solana",
    "ticker": "USDC_SOL"
  }'

# Get all wallets for a customer
curl -X POST https://crypto-api.yativo.com/api/v1/assets/get-customer-assets \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"customer_id": "cust_01abc123"}'

See the Assets page for full documentation on these endpoints.

Customer Data Model

Your Platform Account
├── Customer: Acme Corp (cust_01abc123)
│   ├── Wallet: USDC on Ethereum
│   ├── Wallet: USDC_SOL on Solana
│   └── Transaction history
└── Customer: Beta Inc (cust_02def456)
    └── Wallet: USDT on Polygon

Customer data is isolated — one customer’s wallets and transactions are never accessible from another customer’s context. Your platform account has visibility across all customers.

Store your internal customer ID in the metadata.internal_id field when creating customers. This makes it easy to cross-reference Yativo customer IDs with your own database.

Sandbox Testing

Replace YOUR_SANDBOX_TOKEN with a token obtained by authenticating against https://crypto-sandbox.yativo.com/api/v1/. See Sandbox Overview.

Create a Customer (Sandbox)

curl -X POST 'https://crypto-sandbox.yativo.com/api/v1/customers/create-customer' \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "sandbox-customer@example.com",
    "name": "Sandbox Test Corp",
    "phone": "+14155550100",
    "metadata": {
      "internal_id": "sandbox-cust-001",
      "plan": "test"
    }
  }'

import { YativoSDK } from '@yativo/crypto-sdk';

const sdk = new YativoSDK({
  baseURL: 'https://crypto-sandbox.yativo.com/api/v1/',
  apiKey: 'YOUR_SANDBOX_API_KEY',
  apiSecret: 'YOUR_SANDBOX_API_SECRET',
});

const customer = await sdk.customers.create({
  email: 'sandbox-customer@example.com',
  name: 'Sandbox Test Corp',
  phone: '+14155550100',
  metadata: {
    internal_id: 'sandbox-cust-001',
    plan: 'test',
  },
});
console.log('Customer ID:', customer.customer_id);

List Customers (Sandbox)

curl -X POST 'https://crypto-sandbox.yativo.com/api/v1/customers/get-customers' \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN'

import { YativoSDK } from '@yativo/crypto-sdk';

const sdk = new YativoSDK({
  baseURL: 'https://crypto-sandbox.yativo.com/api/v1/',
  apiKey: 'YOUR_SANDBOX_API_KEY',
  apiSecret: 'YOUR_SANDBOX_API_SECRET',
});

const { customers } = await sdk.customers.list();
console.log('Total customers:', customers.length);

Overview

Wallets & Assets

Transactions

Yativo Card

Payment Gateway

Agentic Wallets

IBAN

Automation

Compliance

B2B

Developer Tools

Tutorials

SDKs

Browser Extensions (Coming Soon)

Sandbox

Create a Customer

Get Customers

Get Customer Transactions

Customer Wallets

Customer Data Model

Sandbox Testing

Create a Customer (Sandbox)

List Customers (Sandbox)

​Create a Customer

​Get Customers

​Get Customer Transactions

​Customer Wallets

​Customer Data Model

​Sandbox Testing

​Create a Customer (Sandbox)

​List Customers (Sandbox)

Create a Customer

Get Customers

Get Customer Transactions

Customer Wallets

Customer Data Model

Sandbox Testing

Create a Customer (Sandbox)

List Customers (Sandbox)