Skip to main content

​
FossaPay Docs Skill

Use Claude Code to integrate the FossaPay API into your application. The skill helps you generate integration code, understand API responses, and handle webhooks.

​
What Can It Do?

Generate API Code

Get working code snippets in JavaScript, Python, or cURL for any FossaPay endpoint

Handle Webhooks

Set up webhook listeners and verify signatures correctly

Build Integrations

Get guided help building payment flows, payouts, and crypto features

Debug Issues

Troubleshoot API errors and understand response formats

​
Quick Start

1

Install Claude Code

npm install -g @anthropic-ai/claude-code
2

Start Claude Code

claude
3

Ask for help

Help me integrate FossaPay to accept payments in my Node.js app

​
Example Prompts

​
Generate Integration Code

Generate code to create a customer and fiat wallet using the FossaPay API

Show me how to send a payout to a Nigerian bank account

Create a webhook handler for FossaPay payment notifications in Express.js

​
Understand the API

What parameters do I need to create a crypto wallet?

How do I verify a bank account before sending money?

What webhook events should I listen for?

​
Build Features

Help me build a complete payment acceptance flow with webhooks

How do I implement crypto deposits in my app?

Generate a payout function with error handling and retries

​
What You’ll Get

When you ask for integration help, Claude will:
  1. Read the API documentation to understand the exact requirements
  2. Generate working code with proper authentication and error handling
  3. Include multiple languages (JavaScript, Python, cURL) when helpful
  4. Explain the flow so you understand what’s happening
  5. Handle edge cases like webhook signature verification

​
Example Output

Ask: “Generate code to accept payments with FossaPay” Claude will provide: 
// 1. Create a customer
const customer = await fetch('https://api-production.fossapay.com/api/v1/customers', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.FOSSAPAY_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    firstName: 'John',
    lastName: 'Doe',
    emailAddress: 'john@example.com',
    mobileNumber: '+2348012345678',
    dob: '1990-01-15',
    address: '123 Main St',
    city: 'Lagos',
    country: 'Nigeria',
    type: 'individual'
  })
});

// 2. Create a fiat wallet for collections
const wallet = await fetch('https://api-production.fossapay.com/api/v1/wallets/fiat/create', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.FOSSAPAY_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customerId: customer.data.id,
    walletName: 'Main Wallet',
    walletReference: 'wallet_001'
  })
});

// 3. Share wallet.data.accountNumber with your user
// 4. Listen for deposit.completed webhook
Plus webhook handling code, error handling, and explanations.

​
API Coverage

The skill has knowledge of all FossaPay endpoints:
CategoryWhat You Can Do
CustomersCreate accounts, list customers, get details
Fiat WalletsCreate wallets, check balances, view transactions
Fiat TransfersSend to banks, verify accounts, calculate fees
Crypto WalletsCreate wallets, check balances, get addresses
Crypto TransfersSend crypto, estimate fees
WebhooksHandle all payment and transfer events

Full API Reference

View complete API documentation with all parameters and responses

​
Tips for Best Results

Be specific - Instead of “help with payments”, try “generate code to create a fiat wallet and handle the deposit webhook in Python”
Ask follow-ups - Claude remembers context, so you can ask “now add error handling” or “convert that to Python”
Request explanations - Ask “explain what each step does” if you want to understand the flow better

​
Need Help?

Quickstart Guide

Get started with FossaPay in minutes

Authentication

Learn about API keys and security

Webhooks

Set up real-time notifications

Community

Get help from the community