Skip to main content
Ready to watch your AI agent move money? Let’s go. This quickstart helps you send your first payment using test wallets (TSD) in either TypeScript or Python.

​
🛠️ Prerequisites

Before writing code, you need to set things up:
  1. 👉 Request an invite and sign in
  2. 🔁 In the dashboard, toggle Developer Mode — this activates TSD wallets
  3. 🧠 Go to the Apps tab and register a new app
    • Add at least one test payee (type: Test Rails)
    • Configure your wallets and choose a policy
  4. 🔐 Copy your Client ID and Client Secret from the Credentials tab
You’re ready to build.

​
📦 Start Building!

  • TypeScript
  • Python

​
1. Install the SDK

npm install @paymanai/payman-ts

​
2. Set up your .env

PAYMAN_CLIENT_ID=your-client-id
PAYMAN_CLIENT_SECRET=your-client-secret

​
3. Send Your First Payment

import { PaymanClient } from "@paymanai/payman-ts";
import "dotenv/config";

const payman = PaymanClient.withCredentials({
  clientId: process.env.PAYMAN_CLIENT_ID!,
  clientSecret: process.env.PAYMAN_CLIENT_SECRET!,
});

async function runDemo() {
  try {
    const wallets = await payman.ask("List all wallets and their balances");
    console.log("💰 Wallets:", wallets);

    const payee = await payman.ask("Create a payee of type Test Rails named John Doe");
    console.log("👤 Payee Created:", payee);

    const payees = await payman.ask("List all payees");
    console.log("📜 All Payees:", payees);

    const payment = await payman.ask("Send 10 TSD to John Doe");
    console.log("✅ Payment Sent:", payment);
  } catch (err: any) {
    console.error("❌ Error:", err.message);
  }
}

runDemo();

​
4. Run it

node index.ts
🎉 That’s It You just:
  • Set up the SDK
  • Created a test payee
  • Sent money using Payman!
✅ Ready for production? Just switch from TSD wallets to USD/USDC, and use your Live Credentials!
Need help? Reach out to [email protected]