Getting Started with MoneyGraph AI
Learn the fundamentals of integrating MoneyGraph into your AI applications
What is MoneyGraph?
MoneyGraph is the universal money movement layer for AI systems. It provides:
- MoneyGraph Agent: Pre-built AI agent for financial operations
- Universal Money API: One API for payments, payouts, FX, KYC across 107+ countries
- AI-Optimized SDK: Structured responses designed for AI agent consumption
- OpenAPI Spec: Complete OpenAPI 3.0 specification for easy integration
Prerequisites
Node.js 18+
Required for SDK installation
API Keys
Get keys from MoneyGraph dashboard
TypeScript
Recommended for type safety
Quick Start
Install the SDK
Add MoneyGraph SDK to your project using npm or your preferred package manager.
npm install @moneygraph/sdkGet Your API Keys
Sign up for a MoneyGraph account and generate your API keys from the dashboard.
Initialize the Client
Set up the MoneyGraph client in your application. Store your API key securely in environment variables.
The exact client initialization code must be verified against the published @moneygraph/sdk v2.0.2 package. The import path, class names, and initialization patterns shown below are placeholders and should not be used until confirmed against the actual SDK.
// TODO: Verify this code against @moneygraph/sdk v2.0.2 before use
// The exact import path and client initialization pattern must be confirmed
// from the actual SDK package before including here.
// Expected pattern (TO BE VERIFIED):
// import { MoneyGraphClient } from '@moneygraph/sdk';
// const client = new MoneyGraphClient({
// apiKey: process.env.MONEYGRAPH_API_KEY,
// environment: 'production' // or 'sandbox'
// });
// DO NOT USE THIS CODE UNTIL VERIFIED AGAINST ACTUAL SDKFor accurate initialization code:
1. Install @moneygraph/sdk
2. Check the package's TypeScript definitions or README
3. Refer to the official documentation at npmjs.com/package/@moneygraph/sdk
Core Concepts
ConceptWallets
Store and manage funds in multiple currencies. Create wallets for different purposes, users, or business units. Support for 73+ currencies.
ConceptPayouts
Send money to bank accounts, mobile wallets, and other destinations in 107+ countries. Automatic FX conversion and local rail delivery.
ConceptPayment Acceptance
Accept credit card payments with embedded widgets or direct API integration. Support for all major card networks.
ConceptKYC & Compliance
Built-in identity verification, document upload, and compliance checks. Automated KYC workflows for customers and recipients.
Environment & API Keys
MoneyGraph provides two environments for development and production:
SandboxDevelopment Environment
Test your integration with simulated transactions. No real money moves. Perfect for development and testing.
ProductionLive Environment
Process real transactions with actual money movement. Requires full KYC verification and compliance approval.
Security Warning: Never expose your API keys in client-side code or commit them to version control. Always use environment variables and keep keys secure.