Quickstart Guide

Get up and running with ClawPay in under 5 minutes.

Prerequisites

• A ClawPay account (sign up here)

• API credentials (available in your dashboard)

• A Solana wallet with USDC or SOL

Step 1: Install the SDK

Choose your preferred language:

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

# Python
pip install clawpay

# Go
go get github.com/ClawPay-app/go-sdk

Step 2: Initialize the Client

import { ClawPay } from '@clawpay/sdk';

const client = new ClawPay({
  apiKey: process.env.CLAWPAY_API_KEY,
  environment: 'production' // or 'sandbox' for testing
});

from clawpay import ClawPay

client = ClawPay(
    api_key=os.environ.get('CLAWPAY_API_KEY'),
    environment='production'
)

import "github.com/ClawPay-app/go-sdk"

client := clawpay.NewClient(&clawpay.Config{
    APIKey:      os.Getenv("CLAWPAY_API_KEY"),
    Environment: "production",
})

Step 3: Create a Vault

Vaults are the core treasury accounts that hold your assets.

const vault = await client.vaults.create({
  name: 'Company Treasury',
  currency: 'USDC',
  network: 'solana',
  initialDeposit: 10000.00
});

console.log(`Vault created: ${vault.id}`);
console.log(`Deposit address: ${vault.depositAddress}`);

Step 4: Define Authorization Rules

Set spending controls programmatically:

await client.vaults.setAuthorizationPolicy(vault.id, {
  type: 'whitelist_only',
  dailyLimit: 5000,
  currency: 'USDC',
  merchants: ['amazon.com', 'aws.amazon.com', 'vercel.com'],
  requiresApproval: {
    above: 1000,
    approvers: ['[email protected]']
  },
  zkProofRequired: true
});

Step 5: Issue a Virtual Card

Generate a debit card linked to your vault:

const card = await client.cards.create({
  vaultId: vault.id,
  cardholderName: 'John Doe',
  spendingLimit: {
    daily: 1000,
    monthly: 25000
  },
  allowedCategories: ['software', 'cloud_services']
});

console.log(`Card number: ${card.maskedNumber}`);
console.log(`CVV: ${card.cvv}`);
console.log(`Expires: ${card.expiryDate}`);

Step 6: Monitor Transactions

Set up webhooks to receive real-time notifications:

await client.webhooks.create({
  url: 'https://your-server.com/webhooks/clawpay',
  events: [
    'transaction.created',
    'transaction.completed',
    'authorization.required',
    'card.declined'
  ],
  secret: 'your-webhook-secret'
});

Next Steps

• Authentication & Security

• Working with Vaults

• Card Management

• Authorization Rules

• Webhooks Guide

• API Reference

Example: Complete Integration

Here's a complete example that creates a vault, sets rules, and issues a card:

import { ClawPay } from '@clawpay/sdk';

async function setupTreasury() {
  const client = new ClawPay({
    apiKey: process.env.CLAWPAY_API_KEY,
    environment: 'production'
  });

  // Create vault
  const vault = await client.vaults.create({
    name: 'Marketing Budget',
    currency: 'USDC',
    network: 'solana',
    initialDeposit: 50000.00
  });

  // Configure authorization rules
  await client.vaults.setAuthorizationPolicy(vault.id, {
    type: 'whitelist_only',
    dailyLimit: 2000,
    currency: 'USDC',
    merchants: [
      'meta.com',
      'google.com',
      'twitter.com'
    ],
    zkProofRequired: true
  });

  // Issue team cards
  const teamMembers = [
    { name: 'Alice Smith', limit: 1000 },
    { name: 'Bob Johnson', limit: 500 }
  ];

  for (const member of teamMembers) {
    const card = await client.cards.create({
      vaultId: vault.id,
      cardholderName: member.name,
      spendingLimit: { daily: member.limit },
      allowedCategories: ['advertising', 'marketing']
    });

    console.log(`Card issued to ${member.name}: ${card.maskedNumber}`);
  }

  // Setup webhooks
  await client.webhooks.create({
    url: 'https://api.yourcompany.com/webhooks',
    events: ['transaction.completed', 'authorization.required']
  });

  console.log('Treasury setup complete!');
  return vault;
}

setupTreasury().catch(console.error);

Sandbox Testing

Use sandbox mode to test integrations without real funds:

const client = new ClawPay({
  apiKey: process.env.CLAWPAY_SANDBOX_KEY,
  environment: 'sandbox'
});

// All operations work identically in sandbox mode
// Test cards will be declined at real merchants

Sandbox test cards:

• 4242 4242 4242 4242 - Successful transactions

• 4000 0000 0000 0002 - Declined (insufficient funds)

• 4000 0000 0000 0069 - Declined (expired card)

Support

Questions? Reach out:

• Email: [email protected]

• Discord: discord.gg/clawpay

• Documentation issues: GitHub