Skip to main content

Overview

Add your own markup to transactions to generate revenue. The developer fee is added on top of StablePay’s platform fee and deducted from the user’s payout.

How It Works

  1. Enable developer fee and set your percentage (0% - 5%)
  2. When a user transacts, your fee is calculated and added
  3. User receives: grossInr - platformFee - developerFee
  4. Your earnings are tracked and shown in account stats

Example Breakdown

User sends $100 USDC:
ComponentAmount
Exchange rate₹84.50
Gross INR₹8,450.00
Platform fee (0.5%)-₹42.25
Developer fee (1%)-₹84.50
User receives₹8,323.25
You earn₹84.50

Setting Up

1. Enable Developer Fee

curl -X PUT https://api.stablepay.global/v2/account/developer-fee \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "percent": 0.01
  }'

2. View Your Settings

curl https://api.stablepay.global/v2/account/developer-fee \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Track Earnings

Earnings are visible in your account stats:
curl https://api.stablepay.global/v2/account/stats \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "developerFeeEarnings": {
    "totalInr": 125000,
    "monthlyInr": 15000
  }
}

Transaction Quote

When developer fee is enabled, transaction quotes show the breakdown:
{
  "quote": {
    "exchangeRate": 84.50,
    "grossInr": "8450.00",
    "platformFeeInr": "42.25",
    "developerFeeInr": "84.50",
    "netInr": "8323.25"
  }
}

API Reference