Learn about all of the most recent updates to the SpherePay API Product. This is where you will find out about new features, API changes, deprecations, compliance updates, and new rails/assets. If you have any questions reach out to support@spherepay.co.Documentation Index
Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
Use this file to discover all available pages before exploring further.
Redesigned Dashboard Navigation & Transfer Flow
The SpherePay dashboard has been overhauled with clearer navigation and a rebuilt Transfer flow.Navigation updates:- Onboarding has moved out of the Transfers section into its own “Get Started” sidebar item, giving customers a clearer path through the platform from day one.
- “Bank Accounts” has been renamed to “External Accounts” to better reflect how the product works.
BRL/PIX Transfers Now Supported
SpherePay now supports BRL (Brazilian Real) transfers via the PIX instant payment network.Supported routes:- Off-ramp: USDC/USDT on Polygon, Ethereum, Base, or Tron → PIX BRL
- On-ramp: PIX BRL → USDC/USDT on Polygon, Ethereum, Base, or Tron
- Transfer limits: R7,500.00 per transfer
- Only
integratorBpsFeeRateis supported for fees (integratorFixedFeeis not allowed). - Solana is not supported for BRL transfers.
- PIX bank accounts require
currency: "brl"andnetworks: ["pix"].
BRL transfers require a separate verification profile (
kyc_profile_b / kyb_profile_b). Contact your SpherePay representative for access.Named Wire Payouts
USD wire payouts now display your business name as the sender instead of “Sphere.” This is enabled automatically when a customer is approved — no manual configuration needed.Existing approved customers who have transacted in the last 3 months have been backfilled and will see this change reflected immediately.API-First Onboarding Defaults
SpherePay now defaults to a streamlined onboarding model for API-integrated applications. KYC and UBO liveness checks, phone and email OTP verification, and MSA signing are no longer required during onboarding when these steps are handled upstream by the integrator.These capabilities remain fully supported and can be enabled as opt-in requirements per application. Existing applications retain their current behavior — only new applications receive the streamlined defaults.For more information, see the Customers & Onboarding guide.Offloader Wallets API + EURC Support
Offloader Wallets API
Offloader Wallets are automated crypto-to-fiat conversion wallets that let your customers receive stablecoins and have them automatically settled to a linked bank account.Supported stablecoins and networks:- USDC on Arbitrum, Avalanche, Base, Ethereum, Polygon, and Solana
- USDT on Ethereum and Tron
- EURC on Base, Ethereum, and Solana
- USD via ACH and Wire
- EUR via SEPA
EURC now supported
EURC is now available across SpherePay’s on-ramp and off-ramp products on Base, Ethereum, and Solana networks.Customer API Suite for Business Customers
Full API support for onboarding and verifying business customers, including UBO registration — giving you complete control over the onboarding UX without redirecting customers to an external flow.New endpoints available:- Register business representative
- Upload UBO identification documents
- Request face liveness verification for UBO
- Submit UBO for verification
Deprecating Transfer Fee API
Transfer fees are now declared directly in the transfer request body. The standalone fee endpoint is no longer needed and will be retired.Customer API Suite for Individual Customers
Full API support for onboarding and verifying individual customers — enabling end-to-end KYC flows inside your own product without redirecting customers to an external page.New endpoints available:- Upload required documents
- Send and verify email OTP
- Send and verify phone OTP
- Request face liveness verification
personalInformation.taxIdentificationNumberpersonalInformation.taxIdentificationNumberTypepersonalInformation.taxIdentificationNumberCountrypersonalInformation.taxIdentificationNumberDescription
Onramper Accounts API
Onramper Accounts generate dedicated virtual bank accounts that automatically convert incoming fiat deposits into stablecoins and deliver them on-chain — no manual intervention required.- Generate dedicated bank accounts per customer or application
- Automatically convert USD/EUR deposits into USDC or USDT
- Deliver converted funds directly to any on-chain wallet address
Starknet Network Support
Starknet is now supported for USDConRamp and offRamp transfers. Use "network": "starknet" in the source or destination of your transfer request.Off-ramp via Starknet:Deprecating /v1/customer
/v2/customer is the new standard for creating and managing customers and will continue to receive new features. See the Customer API reference for migration details.
