Changelog

December 01, 2025

Introducing the Customer API Suite

We’re excited to announce our new Customer API Suite for Individual Customers, enabling you to onboard and verify customers seamlessly via API. This suite provides a comprehensive solution for businesses looking to streamline their onboarding and KYC flows, while maintaining full control over branding and user experience. By integrating onboarding and KYC directly into your application, you can offer a smoother, more secure journey - without requiring customers to leave your app at any stage.

New endpoints are now available for the following actions:

• Upload required documents
• Verify customer phone number
• Verify customer email
• Verify customer authenticity via face liveness verification

Customer create endpoints is now updated to include the following parameters:

• taxIdentificationNumber
• taxIdentificationNumberType
• taxIdentificationNumberCountry
• taxIdentificationNumberDescription

These parameters are required to verify the customer's identity and are used to trigger the KYC via API process. For integrators looking for an easier way to onboard and KYC customers, we recommend using the Customer KYC via Link method.

For more information on how to use the Customer API Suite, please refer to the Customer API Suite guide.

August 21, 2025

Introducing the Virtual Account API

We’re excited to announce our new Virtual Account API, which lets you:

• Generate dedicated bank accounts for your application or customers
• Automatically convert incoming fiat deposits into stablecoins (USDC/USDT)
• Deliver funds directly to on-chain wallet addresses

How to use it?

1. Create a Virtual Account by calling the Virtual Account endpoint:

POST https://api.spherepay.co/v2/virtualAccount
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
    "customerId": "customer_1ab2c3d4",
    "sourceCurrency": "USD",
    "destinationCurrency": "USDC",
    "network": "ethereum",
    "walletAddress": "0x1234...abcd",
    "integratorBpsfee": "10"
}

2. Inspect the response for your new virtualAccount object, including bank deposit instructions:

{
  "id": "virtualAccount_987xyz654",
  "active": true,
  "fees": {
    "totalBpsRate": "20",
    "integratorFee": {
      "bpsRate": "10"
    },
    "platformFee": {
      "bpsRate": "10"
    }
  },
  "depositInstructions": {
    "currency": "USD",
    "bankName": "Bank of Example",
    "bankAccountNumber": "000123456789",
    "bankRoutingNumber": "1234567890",
    "bankBeneficiaryName": "John Doe",
    "bankBeneficiaryAddress": "123 Main St, Anytown, USA"
  },
  "destination": {
    "currency": "USDC",
    "walletAddress": "0x1234...abcd",
    "network": "ethereum"
  },
  "created": "2025-04-20T21:49:46.697Z",
  "updated": "2025-04-20T21:50:18.854Z"
}

3. Fund the account by sending the exact USD amount to the provided bank details. SpherePay will automatically convert the deposit to USDC and deliver it to your wallet.

For full API details, see our Virtual Account API Reference and Virtual Account Guide.

June 18, 2025

Introducing Starknet Network Support

We are excited to announce that we have added support for Starknet network for USDC onRamp and offRamp. This means that you can now accept and send transfers using Starknet network.

How to use it?

You can use the network parameter to specify the network you want to use for the onRamp and offRamp.

{
    "customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
    "amount": "1.12",
    "source": {
        "id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
        "network": "starknet",
        "currency": "usdc"
    },
    "destination": {
        "id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
        "network": "achSameDay",
        "currency": "usd"
    }
}

{
    "customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
    "amount": "2",
    "source": {
        "id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
        "network": "wire",
        "currency": "usd"
    },
    "destination": {
        "id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
        "network": "starknet",
        "currency": "usdc"
    }
}

June 03, 2025

API Endpoint Deprecation

1. API Endpoint Deprecation: The /v1/customer endpoint will be deprecated on June 6, 2025.

   Action Required: Migrate to /v2/customer before the deprecation date.

   Benefits: /v2/customer is the new standard for creating and managing customers and will receive additional features for easier onboarding.

   Migration Guide: See our Customer API documentation for the full details.