Skip to main content

Overview

ACN settles with providers in daily batches. All calls served during a period are aggregated across both payment methods (credits and X402), the platform fee is deducted, and the net amount is sent as a single USDC transfer on Base.

What Gets Settled

Providers earn from two types of calls:
Call TypeHow Developer PaidHow Provider Gets Paid
Credit-paid (API key)Pre-funded Stripe creditsAggregated into daily settlement
X402 on-chainDirect USDC per callAggregated into daily settlement
Both paths are aggregated together into a single daily settlement. From the provider’s perspective, the payment method doesn’t matter — all earned revenue flows through the same settlement process.

Settlement Process

Daily Cycle

  1. Aggregation — All successful calls to your endpoints are summed across both credit and X402 paths
  2. Fee deduction — The 3% platform fee is applied to total earnings
  3. Transfer — Net amount is sent as USDC on Base to your registered wallet
  4. Receipt — Settlement details are available in your provider dashboard

Schedule

EventTime
Settlement periodRolling 24-hour window
Settlement executionDaily at 2:00 AM UTC
On-chain confirmationTypically within minutes

Settlement Details

Each settlement includes a breakdown of calls from both payment paths:
{
  "settlement_id": "stl_abc123",
  "period_start": "2026-03-18T02:00:00Z",
  "period_end": "2026-03-19T02:00:00Z",
  "total_calls": 1520,
  "gross_amount_usdc": "3.04",
  "platform_fee_usdc": "0.091",
  "net_amount_usdc": "2.949",
  "breakdown": {
    "credit_paid_calls": 1350,
    "credit_paid_gross_usdc": "2.70",
    "x402_calls": 170,
    "x402_gross_usdc": "0.34"
  },
  "tx_hash": "0x...",
  "status": "confirmed"
}

Minimum Settlement Threshold

Settlements are processed only when accumulated earnings exceed $0.10 USDC. If your daily earnings are below this, they carry over to the next period.

What’s Not Settled

  • Refunded calls (5xx errors, timeouts) are not included — these are credited back to the developer and don’t count as provider earnings
  • 4xx errors (client errors) are included — if the provider received the request and returned a 4xx, the charge is not refunded to the developer and the provider earns for that call

Provider Wallet

You must have a USDC-compatible wallet on Base to receive settlements. Configure your settlement wallet address during onboarding.
Any standard Ethereum wallet works for receiving USDC on Base — MetaMask, Coinbase Wallet, hardware wallets, etc.

Tracking Settlements

View settlement history in the provider dashboard at provider.acn.exchange, or via API:
curl https://api.acn.exchange/v1/provider/settlements \
  -H "Authorization: Bearer your_provider_key"

Disputes

If you believe a settlement is incorrect:
  1. Review the call log for the settlement period in your provider dashboard
  2. Check that refunded calls (5xx, timeouts) are correctly excluded
  3. Verify the fee calculation: gross × 0.03 = fee
  4. Contact support with the settlement_id