Pricing

1. Customer authorizes $0.02 to merchant
2. Facilitator collects $0.01 from merchant (PRE-SETTLEMENT)
3. IF fee collection succeeds → Execute customer → merchant ($0.02)
4. IF fee collection fails → Block settlement, customer not charged

// $0.01 Resource
// Merchant wants: $0.01
// Add facilitator fee: $0.01
// Customer pays: $0.02

{
  "GET /data": {
    accepts: [{
      price: "$0.02", // $0.01 resource + $0.01 fee
    }]
  }
}

// Flow:
// 1. Facilitator collects $0.01 from merchant (PRE-SETTLEMENT)
// 2. Customer → Merchant ($0.02, direct)
// Net: Merchant receives $0.01

// $0.10 Resource
// Merchant wants: $0.10
// Add facilitator fee: $0.01
// Customer pays: $0.11

{
  "GET /premium-data": {
    accepts: [{
      price: "$0.11", // $0.10 resource + $0.01 fee
    }]
  }
}

// Net: Merchant receives $0.10 (after $0.01 fee)

// $1 Resource
// Merchant wants: $1.00
// Add facilitator fee: $0.01
// Customer pays: $1.01

{
  "GET /analysis": {
    accepts: [{
      price: "$1.01", // $1.00 resource + $0.01 fee
    }]
  }
}

// Net: Merchant receives $1.00 (after $0.01 fee)

# Approve facilitator treasury for USDC spending
node approve-facilitator.mjs

# This executes:
USDC.approve(treasury, 100 * 10^6); // 100 USDC = 10,000 settlements

// 1. Verify customer authorization (FREE)
verifySignature(authorization, signature);

// 2. Collect fee from merchant FIRST (PRE-SETTLEMENT)
USDC.transferFrom(merchant, treasury, 0.01 * 10^6); // $0.01

// 3. IF fee collection succeeded, execute customer → merchant payment
if (feeCollected) {
    executeSettlement(authorization, signature);
} else {
    revert("Settlement blocked - customer not charged");
}

// Example: $0.01 resource
const resourcePrice = 0.01;  // What you want
const facilitatorFee = 0.01; // Fixed fee (PRE-SETTLEMENT)
const customerPrice = 0.02;  // What customer pays

// Per settlement:
merchantReceives = 0.02; // From customer (if settlement executes)
merchantPays = 0.01;     // To facilitator (BEFORE settlement)
netRevenue = 0.01;       // Your profit

// At 1000 successful settlements:
grossRevenue = 0.02 * 1000; // $20.00
totalFees = 0.01 * 1000;    // $10.00 (paid pre-settlement)
netRevenue = 0.01 * 1000;   // $10.00

Approval Amount = Expected Settlements × $0.01

node check-allowance.mjs

# Output:
# Settlements Remaining: 9,550
# Note: Fee collected pre-settlement

node approve-facilitator.mjs

APPROVAL_AMOUNT=0 node approve-facilitator.mjs

# Effect: All settlements blocked at pre-settlement fee collection

1. Customer authorizes $0.02 to merchant
2. Facilitator collects $0.01 from merchant ✅
3. Facilitator executes customer → merchant $0.02 ✅
4. Merchant net: +$0.01 ✅

1. Customer authorizes $0.02 to merchant
2. Facilitator attempts fee collection ❌ (no approval)
3. Settlement BLOCKED 🚫
4. Customer NOT charged ✅
5. Merchant NOT charged ✅

1. Customer authorizes $0.02 to merchant
2. Facilitator attempts fee collection ❌ (no balance)
3. Settlement BLOCKED 🚫
4. Customer NOT charged ✅
5. Merchant NOT charged ✅

1. Customer authorizes $0.02 to merchant
2. Facilitator collects $0.01 from merchant ✅
3. Facilitator attempts settlement ❌ (expired auth, etc.)
4. Merchant paid: -$0.01 (for the attempt)
5. Customer NOT charged ✅

# View pre-settlement fee collection transaction
https://basescan.org/tx/{fee_tx_hash}

# View settlement transaction (executed AFTER fee)
https://basescan.org/tx/{settlement_tx_hash}

# Verify timing: fee_tx timestamp < settlement_tx timestamp

{
  "success": true,
  "details": {
    "settlement_id": "stl_abc123",
    "fee_amount_wei": 10000, // $0.01 fee
    "fee_tx_hash": "0x...",
    "fee_collection_status": "collected",
    "fee_collection_timestamp": "2025-01-29T10:15:00Z",
    "settled_amount": "20000", // $0.02 customer payment
    "settlement_tx_hash": "0x...",
    "settlement_timestamp": "2025-01-29T10:15:45Z",
    "merchant_received": 20000,
    "description": "$0.01 fee collected pre-settlement, then $0.02 customer payment executed"
  }
}