MoneyGraph SDK

Global payments infrastructure for cross-border transfers, FX, and payouts.


Installation

``bash
npm install @moneygraph/sdk
`

$3

`bash


Cursor

cp node_modules/@moneygraph/sdk/.cursorrules .cursorrules
mkdir -p .cursor/rules
cp node_modules/@moneygraph/sdk/.cursor/rules/moneygraph.mdc .cursor/rules/

Windsurf

cp node_modules/@moneygraph/sdk/.windsurfrules .windsurfrules

Amazon Q

mkdir -p .amazonq
cp node_modules/@moneygraph/sdk/.amazonq/rules.md .amazonq/
`

Quick Start

`typescript
import MoneyGraph from '@moneygraph/sdk';

const mg = new MoneyGraph({ apiKey: process.env.MONEYGRAPH_API_KEY });

// Get FX quote
const quote = await mg.fx.quote({
source_currency: 'USD',
destination_currency: 'NGN',
source_amount: 100
});

// Confirm rate (valid for 2 minutes)
await mg.fx.confirm(quote.id);

// Send payout
const payout = await mg.payouts.create({
customer_id: 'cust_xxx',
quote_id: quote.id,
recipient: {
name: 'Recipient Name',
bank_code: '058',
account_number: '0123456789'
},
idempotency_key: payout-${Date.now()}
});
`

Serverless Sandbox

`typescript
const mg = new MoneyGraph({ apiKey: 'sk_test_demo' });
const customer = await mg.customers.createMockPersona('business_verified');
`

API Keys

- Sandbox: Get at moneygraph.ai or use sk_test_demo
- Live: Create account > Complete KYB > Choose plan > Get approved

SDK Methods

$3


`typescript
mg.customers.create(params)
mg.customers.retrieve(id)
mg.customers.kyc.submit(id)
mg.customers.createMockPersona(type)
`

$3

`typescript
mg.fx.quote(params)
mg.fx.confirm(quoteId)
mg.fx.rates()
`

$3

`typescript
mg.payouts.create(params)
mg.payouts.swift.create(params)
mg.payouts.mobileMoney.create(params)
mg.payouts.crypto.create(params)
`

$3

`typescript
mg.cards.create(params)
mg.cards.fund(params)
mg.cards.freeze(id)
`

$3

`typescript
mg.crypto.addresses.create(params)
mg.crypto.deposits.list(params)
mg.crypto.convert.quote(params)
``

Critical Rules

1. Date Format: DD-MM-YYYY
2. KYC Required: Verify before payouts
3. FX Expiry: Quotes expire in 2 minutes
4. Idempotency: Always include unique keys

Links

- Website: moneygraph.ai
- Docs: docs.moneygraph.ai

License

MIT