Skip to main content

​
How settlement works

When an agent makes a payment, settlement is automatic:
  1. Payment authorized:deducted from the card’s balance instantly
  2. Queued for settlement:the transaction enters the settlement pipeline
  3. Settled on-chain:USDC or pathUSD is transferred to the merchant
  4. Confirmed:the transaction status is updated with the on-chain hash

​
Fees

ComponentAmount
Platform fee0.5% of transaction
Per-transaction fee$0.001 (USDC/pathUSD)
On-chain gasCovered by mag3nt
Example: A 10.00 token payment (USDC/pathUSD) costs 0.051 tokens: merchant receives 9.949 tokens.

​
Check settlement status

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

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

​
Settlement states

StatusDescription
SANDBOXTestnet payment authorized. Not settled on-chain.
PENDINGPayment authorized, awaiting batch settlement
IN_PROGRESSSettlement queued and actively being processed
SETTLEDOn-chain transfer confirmed
FAILEDSettlement failed:funds returned to card

​
Timing

  • Authorization: Instant
  • Instant Settlement: Triggers immediately for network-fee efficient transactions.
  • Batch Settlement: Transactions that are not currently fee-efficient are grouped and settled rapidly in batches to optimize network costs.
  • On-chain confirmation: A few seconds on Base, Solana, and Tempo.
Settlement runs automatically. You don’t need to trigger it:just check the status when you need confirmation.