The real Stripe comparison is charge-first vs. order-first

const paymentIntent = await stripe.paymentIntents.create({
  amount: 6384,
  currency: "usd",
  metadata: { order_id: "internal_1042" },
});
// Stripe now knows charge state.
// Your app still owns:
// - line items
// - discounts
// - tax math
// - refund allocation
// - customer-facing order history

const order = await flint.orders.create({
  line_items: [
    { name: "Coffee Beans", quantity: 2,
      unit_price_money: { amount: 1999, currency: "USD" } },
    { name: "Pour-Over Mug", quantity: 1,
      unit_price_money: { amount: 2400, currency: "USD" } },
  ],
  discounts: [{ coupon: { coupon_code: "WELCOME10" } }],
});
// Flint computes totals and keeps the record:
// order.pricing_amounts + order.settlement_amounts → subtotal, discount, tax, paid, refunded, outstanding
// order.activities  → every state change
// order.payment_intent_ids, refund_ids, checkout_session_ids

// Query your own order store
const order = await db.orders.findById(orderId);
// Reconstruct what should be refunded
const subtotal = getRefundableSubtotal(order, returnedItems);
const tax = recalculateTaxShare(order, returnedItems);
// Refund a raw amount
await stripe.refunds.create({
  payment_intent: order.stripePaymentIntentId,
  amount: subtotal + tax,
});
// Then repair your own state
await db.orders.update(orderId, {
  refundedAmount: order.refundedAmount + subtotal + tax,
  status: "partially_refunded",
});

const refund = await flint.refunds.create({
  order_id: "ord_01JY...",
  amount_money: { amount: 2900, currency: "USD" },
  reason: "REFUND_REASON_REQUESTED_BY_CUSTOMER",
  idempotency_key: "refund-support-2900",
});
// Refund lives on the order record.
// order.refund_ids now includes refund.refund_id.
// order.settlement_amounts.refunded_money updates.
// order.status can move to PARTIALLY_REFUNDED.