SDigital2Core Concepts
Understand the fundamental concepts of customers, bank accounts, transactions, and withdrawals in the SDigital2 API
Overview
The SDigital2 API is built around several core concepts that work together to enable cryptocurrency-to-fiat and fiat-to-cryptocurrency conversions. Understanding these concepts is essential for building effective integrations.
Core Concepts
Customers
End-users who send or receive cryptocurrency through your integration
Bank Accounts
PIX payment destinations for off-ramp transactions
Transactions
On-ramp and off-ramp conversions with exchange rate locking
Supported Currencies
Cryptocurrencies, fiat currencies, and payment rails
Withdrawals
Move cryptocurrency to external wallet addresses
Common Integration Flow
- List Customers - Get available customers for your organization
- Check Balances - Verify customer balances across chains
- Get Exchange Rate - Lock in favorable rates for transactions
- Create Transaction - Execute on-ramp or off-ramp operations
- Monitor Progress - Track transaction status until completion
- Handle Withdrawals - Move crypto to external wallets as needed
Best Practices
Rate Management:
- Always use exchange rate locking for price certainty
- Choose appropriate lock durations based on your UX flow
- Handle quote expiration gracefully
Balance Management:
- Check customer balances before creating transactions
- Account for network fees in withdrawal calculations
- Implement balance refresh mechanisms