Developer Documentation

PayDirect is settlement infrastructure for Base mainnet. Accept USDC, ETH, and ADAO payments with automatic fee deduction and forwarding via a simple REST API.

Authentication
Every API call requires a Bearer token
Authorization: Bearer pd_test_abc123...

Sandbox keys start with pd_test_ and live keys with pd_live_. Get your keys from the developer dashboard.

Install the SDK
Official TypeScript and Python SDKs
npm install @paydirect/sdk
import { PayDirectClient } from "@paydirect/sdk";

const client = new PayDirectClient({
  apiKey: "pd_test_abc123...",
  baseUrl: "https://www.paydirect.com/api/v1",
});
Create Your First Payment
Accept USDC on Base mainnet in a few lines of code
const { payment, receivingAddress } = await client.createPayment({
  tokenSymbol: "USDC",
  amount: "15.00",
  merchantWallet: "0xYourBaseAddress...",
  description: "API billing payment",
  metadata: { orderId: "ORD_123" },
});

console.log(payment.id);           // UUID
console.log(payment.status);       // "pending"
console.log(receivingAddress);     // Base wallet to send funds to