Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mag3nt.com/llms.txt

Use this file to discover all available pages before exploring further.

​
How settlement works

When an agent makes a payment, settlement is automatic:
  1. Payment authorized — deducted from the card’s balance instantly
  2. Batched — transactions are grouped for efficiency
  3. Settled on-chain — USDC transferred to the merchant
  4. Confirmed — status updated with transaction hash

​
Fees

ComponentAmount
Platform fee0.5% of transaction
Per-transaction fee$0.05 USDC
On-chain gasCovered by mag3nt
Example: A 10paymentcosts10 payment costs 0.10 — merchant receives $9.90.

​
Check settlement status

const status = await mag3nt.settlement.settlementGetStatus(transactionId);

console.log(status.settlement.status);     // PENDING | SETTLED | FAILED
console.log(status.settlement.feeAmount);  // 0.10
console.log(status.settlement.settledAt);  // 2026-05-21T00:30:00Z

​
Settlement states

StatusDescription
PENDINGPayment authorized, awaiting settlement
SETTLEDOn-chain transfer confirmed
FAILEDSettlement failed — funds returned to card
DEFERREDBelow threshold, settles in next batch

​
Timing

  • Authorization: Instant
  • Settlement: Typically within 5–15 minutes
  • On-chain confirmation: A few seconds on Base
Settlement runs automatically. You don’t need to trigger it — just check the status when you need confirmation.