Skip to main content

Get Started with FossaPay

This quickstart guide will have you making your first API call in minutes. We’ll create a fiat wallet, simulate a payment, and handle the webhook notification.

Prerequisites

Before you begin, make sure you have:
  • A FossaPay account (Sign up here)
  • Your API keys from the dashboard
  • Node.js installed (or your preferred programming language)

Step 1: Get Your API Keys

1

Sign up

Create an account at dashboard.fossapay.com
2

Get Test Keys

Navigate to SettingsAPI Keys and copy your test secret key (starts with fp_test_sk_)
3

Store Securely

Save your API key as an environment variable:

Step 2: Make Your First API Call

Use cURL for direct API calls.

Step 3: Create Your First Fiat Wallet

Let’s create a fiat wallet for collecting payments:
Expected Response:

Step 4: Handle Webhook Notification

When a payment is received, FossaPay sends a webhook to your server. Here’s how to handle it:
Local Testing: Use ngrok to expose your local server for webhook testing:
Then set the ngrok URL in your webhook settings.

Step 6: Send a Payout

Now let’s send money from your wallet to a bank account:

Complete Example

Here’s a complete example that ties everything together:

Next Steps

Authentication

Learn about API authentication and security

Collections Guide

Complete guide to accepting payments

Payouts Guide

Send money to bank accounts

Webhooks

Handle real-time notifications

Testing Checklist

Before going to production, make sure you’ve tested:
  • Creating a customer
  • Creating virtual accounts
  • Receiving and processing webhooks
  • Handling webhook failures
  • Sending payouts
  • Error handling
  • Webhook signature verification

Going Live

When you’re ready for production:
  1. Complete business verification in the dashboard
  2. Switch to live API keys (starts with fp_live_sk_)
  3. Update webhook URL to your production server
  4. Test with small amounts before full launch
  5. Monitor the dashboard for any issues

Get Live API Keys

Complete verification to get live access

Need Help?

Join Community

Get help from the FossaPay community

Contact Support

Email our support team

API Reference

Explore the full API documentation

Dashboard

View your transactions and settings