Integrations

The Integrations section provides an overview of the networks, assets, and environments supported by Tsara’s stablecoin infrastructure, along with testing resources and best practices.

This page helps developers and businesses configure their systems for both sandbox (testing) and production (live) environments.

Supported Networks & Stablecoins

Network	Asset	Type	Environment	Status
Solana Mainnet	USDC	Stablecoin	Production	✅ Active
Solana Devnet	USDC	Test Stablecoin	Sandbox	🧪 Testing

Notes:

Tsara’s stablecoin operations are currently live on Solana only.
Support for Ethereum and Base is planned for future updates.
Each environment (Mainnet or Devnet) operates independently — wallets, addresses, and transactions do not overlap.

Environment Base URLs

Environment	Base URL	Description
Production (Mainnet)	`https://api.tsara.ng/v1`	Live environment for real USDC transactions.
Sandbox (Devnet)	`https://sandbox.tsara.ng/v1`	Safe environment for development and testing.

💡 Always test your integration in sandbox before switching to production.

Developer Resources

Solana Faucet (for Sandbox)

To get test USDC on Solana Devnet, use:

Solana Faucet: https://faucet.solana.com
SPL Token Faucet: https://spl-token-faucet.com

You can send test USDC to any address generated from your Tsara sandbox wallet.

RPC Providers (Optional for Debugging)

If you need to view on-chain transaction details or verify receipts manually, you can use:

Solana Explorer: https://explorer.solana.com
Solana Devnet Explorer: https://explorer.solana.com?cluster=devnet

Tsara automatically synchronizes all transactions, so direct RPC access isn’t required.

Integration Checklist

Before going live, confirm that you’ve:

✅ Created a sandbox wallet for USDC.
✅ Tested onramp and offramp flows end-to-end.
✅ Received webhook notifications (stablecoin.received, onramp.success, etc.).
✅ Verified webhook signature validation using your Webhook Secret Key.
✅ Rotated and secured all API keys before enabling production.

Integration Best Practices

1️⃣ Always verify webhooks using your HMAC-SHA512 signature — never trust payloads blindly.
2️⃣ Use metadata (like invoice IDs or transaction tags) for tracking and reconciliation.
3️⃣ Avoid mixing sandbox and production credentials — they belong to different networks.
4️⃣ Monitor wallet activity through your dashboard and use the /transactions endpoint for history.
5️⃣ Retry idempotently — handle repeated events or webhook retries gracefully using event.id.

Example Integration Flow

A business platform that wants to accept and settle in USDC can:

Create a Tsara stablecoin wallet via the API.
Generate a deposit address for each customer or order.
Receive on-chain payments directly into Tsara’s wallet.
Get notified through the stablecoin.received webhook.
Offramp or settle in fiat to a bank account instantly.

Example Wallet Integration Snippet

# Step 1: Create a stablecoin wallet
curl -X POST "https://sandbox.tsara.ng/v1/wallets" \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "stablecoin",
    "network": "solana",
    "asset": "USDC"
  }'

# Step 2: Generate a deposit address
curl -X POST "https://sandbox.tsara.ng/v1/wallets/wal_123/addresses" \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label": "Customer Payment Address"}'

# Step 3: Listen for the stablecoin.received webhook
# Once received, update wallet balance in your system

Wallet — Create and manage stablecoin wallets.
Addresses — Generate blockchain deposit addresses.
Ramping — Onramp and Offramp between fiat and USDC.
Webhooks — Listen for on-chain events in real time.