Introduction

Welcome to the **Velo SDK for Node.js** documentation. The Velo SDK is a server-side alpha package designed to streamline checkout session creation, payment state verification, and webhook handling.

By wrapping Velo's secure REST endpoints, the SDK allows you to handle stablecoin payments (like USDC) on Stellar without exposing raw keys to frontend code, dealing with direct HTTP headers, or leaking project details to users.

import { Velo } from "@carts1024/velo-sdk";

const velo = new Velo({ apiKey: process.env.VELO_API_KEY! });
const session = await velo.checkout.sessions.create({
  amount: "10.00",
  asset: "USDC",
  description: "Order #1001"
});

// redirect the user to session.checkoutUrl

Key Features

• **Class-Based API Client**: Strongly typed request validation and normalization.
• **Secure Webhook Signatures**: Built-in HMAC-SHA256 timestamped verification.
• **Idempotent API Requests**: Avoid duplicate charges during transaction retries.
• **Cursor Pagination**: Seamless listing and reconciliation of payment intents.