Quick Start Setup
This guide will help you set up Conto and make your first agent payment.
Prerequisites
- Node.js 18+ or Bun
- An AI agent that can make HTTP requests
Step 1: Create Your Account
Sign Up
Visit conto.finance and create your account using email or Google OAuth. Create Organization
After signing in, create your organization. This is the top-level container for all your agents, wallets, and policies.
Invite Team (Optional)
Invite team members and assign roles:
- Owner - Full access including billing
- Admin - Full access except billing
- Manager - Manage agents, wallets, transactions
- Viewer - Read-only access
Step 2: Create an Agent
Navigate to Agents
Go to Agents in the sidebar and click New Agent.
Configure Agent
Enter your agent’s details:Name: Customer Support Agent
Type: OpenAI Assistant (or your framework)
Description: Handles customer inquiries and payments
Generate SDK Key
After creating the agent, go to the SDK Keys tab and click Generate New Key.Save this key immediately! It will only be shown once.
conto_agent_xxx... Step 3: Create a Wallet
Navigate to Wallets
Go to Wallets in the sidebar and click Create Wallet.
Configure Your Wallet
Enter wallet details:
- Name: Give it a descriptive name like “Operations Wallet”
- Network: Choose EVM (Base, Ethereum) or Solana
- Custody Provider: Select how keys are managed
- Privy (Recommended) - Enterprise-grade security with policy controls
- Sponge - Fast setup with gas sponsorship
Fund Your Wallet
Send stablecoins to your new wallet address to enable transactions.
Step 4: Link Agent to Wallet
Open Agent Details
Go to your agent’s detail page and click Assign Wallet.
Configure Spend Limits
Set your spending limits:| Limit | Recommended Start |
|---|
| Per-Transaction | $100 |
| Daily | $500 |
| Weekly | $2,000 |
| Monthly | $5,000 |
Set Time Windows (Optional)
Restrict transactions to business hours if needed:
- Start: 9 AM
- End: 5 PM
- Days: Monday - Friday
Step 5: Install the SDK
Step 6: Make Your First Payment
import { Conto } from '@conto/sdk';
// Initialize the SDK
const conto = new Conto({
apiKey: process.env.CONTO_API_KEY, // conto_agent_xxx...
});
// Make a payment
async function makePayment() {
try {
const result = await conto.payments.pay({
amount: 10.00,
recipientAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f...',
recipientName: 'Test Vendor',
purpose: 'Test payment',
category: 'TESTING'
});
console.log('Payment successful!');
console.log('Transaction hash:', result.txHash);
console.log('Explorer:', result.explorerUrl);
} catch (error) {
console.error('Payment failed:', error.message);
}
}
makePayment();
Verification
After running the code:
- Check your Transactions page in the dashboard
- Verify the transaction status is “Confirmed”
- Check your wallet balance has decreased
Congratulations! You’ve successfully set up Conto and made your first payment.
Next Steps
