Conto with Stripe Link

npm install @conto_finance/sdk@latest

import { Conto, CheckoutApprovalPendingError } from '@conto_finance/sdk';

const conto = new Conto({ apiKey: process.env.CONTO_API_KEY! });

// 1. Right before Link opens.
let checkpoint = await conto.checkout.begin({
  idempotencyKey: order.id,
  merchant: { id: 'acme-retail', name: 'ACME Retail', checkoutUrl: page.url() },
  amountMinor: 1500,
  purpose: 'Phone charger the shopper chose',
  category: 'EQUIPMENT', // From trusted checkout configuration, not model-selected authority.
  lineItems: [{ name: 'USB-C phone charger', quantity: 1, unitAmountMinor: 1500 }],
});

if (checkpoint.stage === 'AWAITING_APPROVAL') {
  // Required reviewers must approve first. Do not open Link yet.
  checkpoint = await conto.checkout.waitForApproval(checkpoint);
}
if (checkpoint.stage !== 'APPROVED') {
  throw new Error('Inspect the existing purchase before continuing.');
}

// Your adapter opens Link; the buyer completes any Link authorization.
await checkout.openLink();

// 2. Right before payment, reread the actual cart on every attempt.
let confirmed;
let finalCart;
for (let attempt = 0; attempt < 3; attempt += 1) {
  finalCart = await checkout.readFinalCart();
  // Includes amountMinor, currency, lineItems, totals and pageUrl.
  try {
    confirmed = await conto.checkout.confirm(checkpoint, finalCart);
    break;
  } catch (error) {
    if (!(error instanceof CheckoutApprovalPendingError)) throw error;
    checkpoint = await conto.checkout.waitForApproval(error.checkpoint);
    // Reobserve after review; never reuse the pre-review cart.
  }
}
if (confirmed?.stage !== 'CONFIRMED') {
  throw new Error('Stop and review the changing checkout before paying.');
}

// Your trusted executor must recheck finalCart and atomically claim dispatch
// for this purchase before submitting once. Confirmation is not a dispatch lock.

const { outcome, reference } = await checkout.submitOnce({
  purchaseId: order.id,
  checkpoint: confirmed,
  finalCart,
});

// 3. Report the observed result, not an assumed success.
await conto.checkout.reportOutcome(confirmed.id, { outcome, reference });