Back to Articles
Tutorials5 minJanuary 15, 2025

Building Payment Apps with Claude.ai and MoneyGraph

How to use Claude.ai Projects with MoneyGraph SDK. Copy our project instructions and let Claude build compliant payment integrations automatically.

By MoneyGraph Team

Claude.ai from Anthropic is one of the most capable AI assistants for complex reasoning and code generation. With MoneyGraph's CLAUDE_AI_INSTRUCTIONS.md, Claude understands how to build compliant payment applications from your first prompt.

Why Claude + MoneyGraph?

FeatureClaude.aiMoneyGraphTogether
Complex Reasoning✅ Understands KYC flows✅ Built-in complianceAI understands rules
Code Generation✅ Complete, working code✅ 40+ API endpointsProduction-ready output
Precision✅ Follows instructions✅ Strict SDK patternsNo hallucinations
Explanation✅ Explains reasoning✅ Clear documentationAudit-friendly code
Payment Rails✅ Local, SWIFT, mobile, cryptoGlobal coverage
Multi-Currency✅ 107+ countriesUniversal payments

Together, they create a powerful fintech development environment.

Setup: Add Project Instructions

In Claude.ai:

  1. Create a new Project
  2. Go to Project Knowledge
  3. Paste the contents of CLAUDE_AI_INSTRUCTIONS.md

That's it. Claude now understands MoneyGraph.

Quick Start Prompt

Try this prompt in your Claude Project:

I need to build a remittance API using MoneyGraph SDK.

Build a REST API with these endpoints: - POST /customers - Register new customer - POST /customers/:id/kyc - Submit KYC documents - POST /quotes - Get FX quote (USD to any currency) - POST /payouts - Send money internationally

Rules: - Always check KYC status before allowing payouts - Use Quote → Confirm → Payout flow for FX - Handle MoneyGraph error types properly - Use environment variables for API keys - Add proper TypeScript types

First, npm install @moneygraph/sdk, then build the API. ```

Claude will generate a complete, production-ready REST API with compliance built-in!

What Claude Learns

Our project instructions teach Claude:

ConceptWhat Claude Understands
KYC Before PayoutsAlways verify customer before sending money
Quote → Confirm → PayoutThe correct FX flow with rate locking
All SDK NamespacesWhich namespace to use for each operation
Error HandlingProper error types and user-friendly messages
Compliance RulesRegulatory requirements built into code

The Golden Rule: KYC Before Payouts

// Claude always generates this check
const status = await mg.customers.kyc.canPayout(customerId);
if (!status.allowed) {
  throw new Error(`KYC not approved: ${status.status}`);
}

Quote → Confirm → Payout

// Claude knows the FX flow
const quote = await mg.fx.quote({ from: 'USD', to: 'NGN', amount: 100 });
await mg.fx.confirm(quote.id);  // Lock rate for 2 minutes
const payout = await mg.payouts.create({ quote_id: quote.id, ... });

All SDK Namespaces

Claude knows which namespace to use for each operation:

NeedClaude UsesExample
Verify identity`mg.customers.kyc`KYC verification and status
Send to M-Pesa`mg.payouts.mobileMoney`Mobile money payouts
Issue cards`mg.cards`Virtual and physical cards
Check FX rates`mg.fx.rates`Current exchange rates
Optimize routing`mg.r3.recommend`Best route for payout
Accept payments`mg.payments`Card payment processing

Example Prompts

Try these prompts with Claude:

Build a Remittance API

Prompt: "Build a REST API for a remittance service using MoneyGraph. Users should be able to register, complete KYC, and send money to Nigeria."

Claude generates:

  • Express.js routes
  • Customer registration with validation
  • KYC submission flow
  • Quote and payout endpoints
  • Error handling with MoneyGraph error types

Create a Wallet System

Prompt: "Create a multi-currency wallet system where users can hold USD, EUR, and NGN. Include FX conversion between currencies."

Claude generates:

  • Wallet creation for each currency
  • Balance checking
  • FX quote display with countdown
  • Wallet-to-wallet transfers

Issue Virtual Cards

Prompt: "Build a virtual card issuance feature. Users with approved KYC can create USD cards and fund them from their wallet."

Claude generates:

  • KYC verification before issuance
  • Card creation with spending limits
  • Funding from wallet balance
  • Card freeze/unfreeze controls

Getting Started

StepAction
1Install the SDK: `npm install @moneygraph/sdk`
2Copy `CLAUDE_AI_INSTRUCTIONS.md` to your Claude Project Knowledge
3Ask Claude to build payment features using MoneyGraph SDK

Next Steps:

Claude is now your fintech-aware AI coding partner with built-in compliance knowledge.

Ready to Get Started?

Install MoneyGraph SDK and start building AI-native payment applications today