Development - XentFi API Documentation

This guide covers setting up your development environment for testing and integrating XentFi APIs.

Test Networks

XentFi provides test networks for all supported blockchains to help you develop and test without using real funds.

Available Testnets

Network	Chain ID	Faucet URL	Native Token
Sepolia	11155111	Get ETH	ETH
Base Sepolia	84532	Get ETH	ETH
Mumbai	80001	Get MATIC	MATIC
Arbitrum Sepolia	421614	Get ETH	ETH
Optimism Sepolia	11155420	Get ETH	ETH
BNB Testnet	97	Get BNB	BNB
Solana Devnet	1	Get SOL	SOL

Development vs Production Comparison

Aspect	Development	Production
Network	Testnet (Sepolia, Mumbai, etc.)	Mainnet
API Keys	Sandbox keys	Production keys
Funds	Faucet tokens (free)	Real cryptocurrency
Transaction Cost	Free (testnet gas)	Real gas fees
Rate Limits	Higher limits	Standard limits
Monitoring	Optional	Required
Webhooks	Use ngrok for local testing	Production endpoints

Environment Setup

1. Get Sandbox API Keys

Log into Dashboard

Go to dashboard.xentfi.com

Create Sandbox Keys

Navigate to Settings → API Keys and select “Sandbox” environment

Save Credentials

Copy your sandbox apiKey and orgId

2. Configure Environment Variables

Create a .env file in your project:

# XentFi Sandbox Configuration
XENTFI_API_KEY=your_sandbox_api_key
XENTFI_ORG_ID=your_org_id
XENTFI_BASE_URL=https://api.xentfi.com/v1
XENTFI_ENVIRONMENT=sandbox

# Webhook Testing (optional)
XENTFI_WEBHOOK_SECRET=your_webhook_secret
XENTFI_WEBHOOK_URL=https://your-ngrok-url/webhooks/xentfi

# Network Configuration (optional)
XENTFI_DEFAULT_NETWORK=sepolia

3. Install SDK

# Node.js / TypeScript
npm install @xentfi/sdk

# Python
pip install xentfi

# Go
go get github.com/xentfi/xentfi-go

4. Initialize Client

// Node.js
import { XentFiClient } from '@xentfi/sdk';

const client = new XentFiClient({
apiKey: process.env.XENTFI_API_KEY,
orgId: process.env.XENTFI_ORG_ID,
environment: 'sandbox',
network: 'sepolia' // default testnet
});

# Python
from xentfi import XentFiClient

client = XentFiClient(
api_key=os.environ['XENTFI_API_KEY'],
org_id=os.environ['XENTFI_ORG_ID'],
environment='sandbox',
network='sepolia'
)

Local Development with Testnet

Getting Test Tokens

Create a Test Wallet

First, create a master wallet on your chosen testnet:

curl -X POST https://api.xentfi.com/v1/master-wallets \
-H "apiKey: $XENTFI_API_KEY" \
-H "orgId: $XENTFI_ORG_ID" \
-d '{
"name": "Test Wallet",
"blockchainId": "eth-sepolia"
}'

Get Wallet Address

Copy the walletAddress from the response.

Request Test Tokens

Visit the faucet for your chosen testnet and paste your wallet address.

Verify Balance

curl -X GET https://api.xentfi.com/v1/addresses/{addressId}/balance \
-H "apiKey: $XENTFI_API_KEY" \
-H "orgId: $XENTFI_ORG_ID"

Webhook Testing with ngrok

For local webhook development, use ngrok to expose your local server:

# Install ngrok (macOS)
brew install ngrok

# Or download from https://ngrok.com/download

# Start ngrok on port 3000
ngrok http 3000

# Copy the HTTPS URL (e.g., https://abc123.ngrok.io)

Configure your webhook with the ngrok URL:

curl -X POST https://api.xentfi.com/v1/webhooks \
-H "apiKey: $XENTFI_API_KEY" \
-H "orgId: $XENTFI_ORG_ID" \
-d '{
"url": "https://abc123.ngrok.io/webhooks/xentfi",
"events": ["payment.completed", "payment.failed"],
"secret": "your-webhook-secret"
}'

Sample Development Workflow

flowchart LR
subgraph Local["Local Development"]
Code[Write Code]
Test[Run Tests]
Debug[Debug Issues]
end

subgraph Testnet["Testnet Environment"]
Wallet[Create Test Wallet]
Payment[Process Test Payment]
Webhook[Receive Webhook]
end

subgraph Production["Production"]
Deploy[Deploy to Production]
Monitor[Monitor Transactions]
end

Local --> Testnet
Testnet --> Production

Testing Checklist

Before moving to production, ensure you’ve tested:

Common Development Issues

Insufficient testnet funds

Solution: Request more tokens from the faucet. Some faucets have daily limits.

Webhook not received

Solution:

Verify ngrok is running
Check webhook URL is accessible
Verify signature verification

Transaction not confirming

Solution:

Testnet may be congested
Increase gas limit
Wait and retry

Rate limit hit during testing

Solution:

Sandbox has higher limits
Implement delays between requests
Contact support for temporary increase

Migrating to Production

Generate Production Keys

Create new API keys with “Production” environment in dashboard

Update Configuration

Change environment from sandbox to production

Deploy Webhooks

Update webhook URLs to production endpoints

Create Production Wallets

Deploy wallets on mainnet networks

Enable Monitoring

Turn on monitoring for all production wallets

Go Live

Update your application configuration and launch

Pre-Migration Checklist

All tests pass on testnet
Error handling implemented
Rate limit handling in place
Webhook signature verification working
Idempotency keys implemented
Monitoring and alerting configured
Security review completed
Backup and recovery procedures ready

Support During Development

📧 Developer Support: dev@xentfi.com
💬 Discord: #dev channel
📚 API Reference: docs.xentfi.com/api-reference
🐛 Report Issues: GitHub Issues

Next Steps

Authentication

Learn about API security best practices

Rate Limits

Understand API rate limiting

Products

Explore all XentFi products

API Reference

Browse complete API documentation

Quickstart Guide Master Wallets

​Test Networks

​Available Testnets

​Development vs Production Comparison

​Environment Setup

​1. Get Sandbox API Keys

​2. Configure Environment Variables

​3. Install SDK

​4. Initialize Client

​Local Development with Testnet

​Getting Test Tokens

​Webhook Testing with ngrok

​Sample Development Workflow

​Testing Checklist

​Common Development Issues

​Migrating to Production

​Pre-Migration Checklist

​Support During Development

​Next Steps

Authentication

Rate Limits

Products

API Reference

Test Networks

Available Testnets

Development vs Production Comparison

Environment Setup

1. Get Sandbox API Keys

2. Configure Environment Variables

3. Install SDK

4. Initialize Client

Local Development with Testnet

Getting Test Tokens

Webhook Testing with ngrok

Sample Development Workflow

Testing Checklist

Common Development Issues

Migrating to Production

Pre-Migration Checklist

Support During Development

Next Steps