Skip to main content

Business Onboarding

Welcome to Torque! This guide will walk you through setting up your business account, getting your API credentials, and making your first integration.

Quick Start (5 Minutes)​

1. Create Account​

  • Visit torque.fi/business
  • Connect your wallet (MetaMask, WalletConnect, etc.)
  • Complete basic business information

2. Get API Credentials​

  • Navigate to API Settings
  • Generate your first API key
  • Note your Business ID

3. Test Integration​

  • Use our test endpoint
  • Generate your first checkout link
  • Verify everything works

Account Setup​

Step 1: Wallet Connection​

Connect your preferred cryptocurrency wallet:

MetaMask​

  1. Install Extension: metamask.io
  2. Create Wallet: Set up new wallet or import existing
  3. Switch Network: Ensure you're on the correct network
  4. Connect: Click "Connect Wallet" and select MetaMask

WalletConnect​

  1. Install App: Download WalletConnect mobile app
  2. Scan QR Code: Scan the QR code displayed on screen
  3. Approve Connection: Approve the connection in your mobile app

Other Wallets​

  • Coinbase Wallet: Install extension and connect
  • Trust Wallet: Use mobile app with WalletConnect
  • Rainbow: Connect via WalletConnect

Step 2: Business Profile​

Complete your business profile with accurate information:

Required Information​

  • Business Name: Your official business name
  • Business Type: Corporation, LLC, Partnership, etc.
  • Industry: Ecommerce, Services, Digital Products, etc.
  • Country: Your business location
  • Contact Email: Business email address

Optional Information​

  • Website: Your business website
  • Description: Brief business description
  • Logo: Business logo (recommended)
  • Social Media: LinkedIn, Twitter, etc.

Verification Documents​

  • Business License: Government-issued business license
  • Tax Documents: EIN or tax identification number
  • Address Verification: Business address documentation

Step 3: Payment Wallet​

Set up your payment destination wallet:

Primary Wallet​

  • Wallet Address: Where you'll receive payments
  • Network: Ensure it's the correct blockchain network
  • Verification: Double-check the address is correct

Backup Wallet (Optional)​

  • Secondary Address: Backup payment destination
  • Multi-sig: Consider using a multi-signature wallet for security

🔑 API Credentials​

Getting Your Credentials​

Business ID​

Your unique business identifier:

business_123abc456def

Location: Dashboard → Account → Business ID Format: Always starts with business_ followed by alphanumeric characters

API Key​

Your authentication key for API requests:

torque_live_789ghi012jkl345mno678pqr

Location: Dashboard → API → Generate New Key Format: Starts with torque_live_ followed by 32 characters

API Key Management​

Generate New Key​

  1. Navigate: Dashboard → API → Generate New Key
  2. Confirm: Verify you want to create a new key
  3. Copy: Immediately copy the new key (it won't be shown again)
  4. Store: Save in a secure location

Key Permissions​

  • Read Access: View orders, analytics, and business data
  • Write Access: Create checkout links, manage orders
  • Admin Access: Full account management (use sparingly)

Key Security​

  • Environment Variables: Store in .env files (never commit to code)
  • Secret Management: Use services like AWS Secrets Manager, HashiCorp Vault
  • Access Control: Limit who has access to API keys
  • Rotation: Regularly rotate keys (every 90 days recommended)

First Integration​

Test Environment​

Sandbox Mode​

  • Test API Keys: Use test credentials for development
  • Test Endpoints: All endpoints work in test mode
  • No Real Payments: Test without processing real transactions
  • Reset Data: Test data can be cleared between sessions

Test Credentials​

# Test API Key
TORQUE_API_KEY=torque_test_1234567890abcdef

# Test Business ID
TORQUE_BUSINESS_ID=business_test_123

Basic Checkout Test​

Simple Test Request​

curl -X POST https://api.torque.fi/v1/checkout/generate-link \
  -H "Authorization: Bearer YOUR_TEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "businessId": "YOUR_TEST_BUSINESS_ID",
    "cart": {
      "items": [
        {
          "productId": "test_prod_1",
          "quantity": 1,
          "price": 9.99
        }
      ]
    },
    "customerData": {
      "email": "test@example.com",
      "firstName": "Test",
      "lastName": "User"
    }
  }'

Expected Response​

{
  "success": true,
  "checkoutUrl": "https://checkout.torque.fi/session/test123",
  "sessionId": "session_test123",
  "expiresAt": "2024-01-15T11:30:00Z"
}

Test Scenarios​

1. Basic Checkout​

  • Single product, simple customer data
  • Verify checkout link generation
  • Test checkout flow completion

2. Multi-Product Cart​

  • Multiple items with different prices
  • Test quantity and variant handling
  • Verify total calculation

3. Customer Data​

  • Test with and without address
  • Verify optional field handling
  • Test data validation

4. Error Handling​

  • Test with invalid data
  • Verify error responses
  • Test rate limiting

Webhook Setup​

Configure Webhooks​

Webhook Endpoint​

Set up your webhook receiver:

// Express.js example
app.post('/webhooks/torque', async (req, res) => {
  try {
    // Verify webhook signature
    const signature = req.headers['x-torque-signature'];
    if (!verifyWebhookSignature(req.body, signature, webhookSecret)) {
      return res.status(401).json({ error: 'Invalid signature' });
    }
    
    // Process webhook
    const { event, data } = req.body;
    console.log('Webhook received:', event, data);
    
    res.json({ success: true });
  } catch (error) {
    console.error('Webhook error:', error);
    res.status(500).json({ error: 'Processing failed' });
  }
});

Webhook Configuration​

  1. URL: Your webhook endpoint URL
  2. Events: Select which events to receive
  3. Secret: Generate webhook secret for verification
  4. Test: Send test webhook to verify setup

Test Webhooks​

Local Testing​

Use ngrok for local development:

# Install ngrok
npm install -g ngrok

# Expose local server
ngrok http 3000

# Use ngrok URL in webhook configuration
# https://abc123.ngrok.io/webhooks/torque

Webhook Events​

Test these common events:

  • order.created: New order created
  • order.paid: Payment received
  • order.completed: Order completed
  • order.cancelled: Order cancelled

📊 Dashboard Overview​

Main Dashboard​

Key Metrics​

  • Total Revenue: Lifetime revenue from all orders
  • Order Count: Total number of orders
  • Conversion Rate: Percentage of checkouts completed
  • Average Order Value: Mean order value

Recent Activity​

  • Latest Orders: Recent order activity
  • Payment Status: Payment confirmations and failures
  • Customer Activity: New and returning customers

Order Management​

Order List​

  • Status Filter: Filter by order status
  • Date Range: Select time period
  • Search: Find specific orders
  • Export: Download order data

Order Details​

  • Customer Information: Contact and address details
  • Cart Contents: Products, quantities, prices
  • Payment Details: Method, status, transaction ID
  • Timeline: Order creation, payment, completion

Analytics​

Performance Metrics​

  • Revenue Trends: Daily, weekly, monthly revenue
  • Order Analytics: Order volume and patterns
  • Customer Insights: Demographics and behavior
  • Product Performance: Best-selling products

Custom Reports​

  • Date Ranges: Flexible time period selection
  • Filters: Filter by status, amount, location
  • Export Options: CSV, JSON, PDF formats
  • Scheduled Reports: Automated report delivery

🚨 Go Live Checklist​

Pre-Launch Verification​

✅ Account Setup​

  • Business profile completed
  • Verification documents submitted
  • Payment wallet configured
  • API credentials generated

✅ Integration Testing​

  • Test checkout links working
  • Webhooks receiving events
  • Error handling implemented
  • Rate limiting configured

✅ Security Review​

  • API keys secured
  • Webhook signatures verified
  • HTTPS enabled
  • Access controls configured

Production Deployment​

Switch to Live Mode​

  1. Update Credentials: Use live API keys
  2. Update Endpoints: Point to production URLs
  3. Test Live: Verify live checkout flow
  4. Monitor: Watch for any issues

Production Monitoring​

  • Order Volume: Track checkout usage
  • Error Rates: Monitor API errors
  • Performance: Check response times
  • Webhook Delivery: Verify webhook success rates

Troubleshooting​

Common Issues​

API Authentication Fails​

Problem: Getting 401 Unauthorized errors

Solutions:

  • Verify API key is correct
  • Check API key hasn't expired
  • Ensure proper Authorization header format
  • Verify business account is active

Problem: API returns error when creating checkout

Solutions:

  • Validate cart data format
  • Check required fields are present
  • Verify product IDs are valid
  • Review API error details

Webhooks Not Receiving​

Problem: No webhook events received

Solutions:

  • Verify webhook URL is accessible
  • Check webhook secret is correct
  • Ensure HTTPS is enabled
  • Test webhook endpoint manually

Getting Help​

Support Channels​

Debug Information​

When contacting support, include:

  • Error Messages: Complete error text
  • Request Details: API endpoint, request body
  • Response Headers: HTTP status and headers
  • Logs: Relevant application logs
  • Steps to Reproduce: How to recreate the issue

📚 Next Steps​

Advanced Features​

Platform Integrations​

Business Growth​

🎯 Success Metrics​

Key Performance Indicators​

Revenue Metrics​

  • Monthly Recurring Revenue (MRR): Predictable monthly income
  • Customer Lifetime Value (CLV): Long-term customer value
  • Average Order Value (AOV): Mean transaction size
  • Revenue Growth Rate: Month-over-month growth

Operational Metrics​

  • Checkout Completion Rate: Percentage of successful checkouts
  • Payment Success Rate: Successful payment percentage
  • Customer Acquisition Cost (CAC): Cost to acquire customers
  • Support Ticket Volume: Customer support requests

Customer Metrics​

  • Customer Retention Rate: Returning customer percentage
  • Net Promoter Score (NPS): Customer satisfaction metric
  • Time to First Order: Days from signup to first purchase
  • Customer Support Satisfaction: Support quality rating

Setting Goals​

Short-term (1-3 months)​

  • Complete first 10 orders
  • Achieve 80% checkout completion rate
  • Set up basic analytics dashboard
  • Implement webhook handling

Medium-term (3-6 months)​

  • Reach 100 orders per month
  • Achieve 90% checkout completion rate
  • Implement advanced analytics
  • Add custom checkout themes

Long-term (6+ months)​

  • Scale to 1000+ orders per month
  • Achieve 95% checkout completion rate
  • Implement multi-currency support
  • Add subscription billing

Ready to get started? Create your business account or contact our team for personalized onboarding assistance.