Skip to main content

​
VaultSaaS SDK

VaultSaaS SDK is an open-source TypeScript SDK that simplifies payment orchestration across multiple payment providers. Build unified payment experiences with intelligent routing, automatic failover, and comprehensive error handling.

​
Key features

Multi-provider support

Integrate once and accept payments through Stripe, dLocal, Paystack, and more with a unified API

Intelligent routing

Route transactions based on currency, country, payment method, amount, or custom metadata

Built-in idempotency

Prevent duplicate charges with automatic idempotency key handling and conflict detection

Type-safe API

Full TypeScript support with comprehensive type definitions for all operations

Webhook handling

Unified webhook processing across all providers with automatic signature verification

Platform connector

Optional integration with VaultSaaS Platform for advanced routing and analytics

​
Supported payment providers

VaultSaaS SDK currently supports the following payment providers:
  • Stripe - Global payment processing with extensive payment method support
  • dLocal - Emerging markets payment gateway covering Latin America, Africa, and Asia
  • Paystack - African payment processing with local payment method support
Each provider adapter is fully tested and production-ready.

​
Core capabilities

​
Payment operations

  • Charge - Direct payment capture in a single step
  • Authorize - Reserve funds for later capture
  • Capture - Capture previously authorized funds
  • Refund - Return funds to the customer
  • Void - Cancel an authorized transaction
  • Get Status - Check transaction status across providers

​
Advanced features

  • Automatic routing - Rule-based routing with currency, country, and payment method matching
  • Platform routing - AI-powered routing decisions via VaultSaaS Platform API
  • Idempotency store - Pluggable storage for idempotency records (memory or custom)
  • Error normalization - Consistent error codes and categories across all providers
  • Transaction tracking - Automatic provider mapping for refunds, captures, and voids

​
Get started

Quickstart

Create your first payment in under 10 minutes

Installation

Install the SDK with npm, yarn, pnpm, or bun

API Reference

Explore the complete API documentation

Routing

Learn how to configure intelligent payment routing

​
Requirements

  • Node.js 20+ or Bun 1.1+
  • TypeScript 5.0+ (optional, but recommended)
  • Test API keys from at least one supported provider

​
Open source

VaultSaaS SDK is open source and available under the MIT license. Contributions are welcome!

Build docs developers (and LLMs) love

Get started for freeTalk to us