settle_split

Category: Composed Price: $0.01 On-chain: yes

settle_split executes Sendero's canonical commission fan-out. It takes a gross booking amount and supplier address, then splits the funds into supplier net, agency commission, Sendero rail fee, and validator tip.

Input

{
  gross: string;          // total booking amount in decimal USDC
  supplier: `0x${string}`;
  commissionBps?: number; // default 1000
  senderoFeeBps?: number; // default 100
}

Output

The result comes from @sendero/nanopayments and includes the settlement legs plus Arc transaction data when available.

{
  txHash?: `0x${string}`;
  legs: Array<{
    to: `0x${string}`;
    amount: string;
    label: string;
  }>;
}

HTTP example

curl -X POST $SENDERO_EDGE_URL/tools/settle_split \
  -H "content-type: application/json" \
  -H "Payment-Signature: $BASE64_X402_PAYMENT" \
  -d '{
    "gross": "1275.44",
    "supplier": "0x6a5d2a2e56ed5162f5e29fe1179e59f2b07140e7",
    "commissionBps": 1000,
    "senderoFeeBps": 50
  }'

Why it matters

In legacy ticketing, commission settlement can take weeks and pass through clearinghouses. Sendero collapses the fan-out into a signed, auditable payment action that finalizes on Arc.

For full flight booking, prefer sendero.book_flight; it calls escrow settlement and invoice generation in the correct order.