Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fossapay.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What are Customers?

Customers represent your end users within the FossaPay ecosystem. Every wallet, transaction, and compliance check is associated with a customer account.
Customer accounts are required before you can create wallets or perform transactions on behalf of your users.

​
Customer Lifecycle

​
1. Customer Creation

Create a customer account with basic information: 
curl -X POST https://api-production.fossapay.com/api/v1/customers \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    firstName: 'John',
    lastName: 'Doe',
    middleName: 'Michael',
    emailAddress: 'john.doe@example.com',
    mobileNumber: '+2348012345678',
    dob: '1990-08-15',
    address: '123 Main Street',
    city: 'Lagos',
    country: 'Nigeria',
    type: 'individual'
  }'

​
2. Wallet Creation

Once verified, create wallets for the customer: 
curl -X POST https://api-production.fossapay.com/api/v1/wallets/fiat/create \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cus_123456789",
    "walletName": "Main Wallet",
    "walletReference": "wallet_ref_001"
  }'

​
Customer Tiers

Currently, FossaPay supports individual customer accounts. All customers are created with the individual tier.

​
Best Practices

Always store FossaPay customer IDs in your database for future API calls.
Store additional customer data in metadata for easier management.

​
Next Steps

Create Customer API

API reference for customer creation

Wallets

Create wallets for customers