Session reference

{
  "amount": 5000,
  "currency": "EUR",
  "successUrl": "https://yoursite.com/order/success",
  "cancelUrl": "https://yoursite.com/cart",
  "customer": {
    "customerId": "cust_abc123",
    "email": "jane@example.com",
    "name": "Jane Smith",
    "phone": "+12125551234"
  },
  "cartItems": [
    {
      "id": "item_001",
      "name": "Wireless headphones",
      "description": "Over-ear, noise cancelling",
      "price": 5000,
      "quantity": 1,
      "image": "https://yoursite.com/images/headphones.jpg",
      "maxQuantity": 5
    }
  ],
  "supportedCurrencies": ["EUR", "USD", "GBP"],
  "configId": "default-config",
  "metadata": {
    "mode": "payment",
    "merchantName": "Demo Store",
    "shippingAddressHandling": "Collect",
    "promoCode": {
      "enabled": true,
      "availableCodes": [
        {
          "code": "SAVE20",
          "discount": 20,
          "discountType": "percentage",
          "description": "20% off your order"
        }
      ]
    },
    "delivery": {
      "enabled": true,
      "options": {
        "shipping": {
          "methods": [
            {
              "id": "ups_standard",
              "name": "UPS Standard",
              "price": 599,
              "currency": "EUR",
              "estimatedDays": { "min": 3, "max": 5 }
            },
            {
              "id": "ups_express",
              "name": "UPS Express",
              "price": 1299,
              "currency": "EUR",
              "estimatedDays": { "min": 1, "max": 2 }
            }
          ]
        },
        "pickup": {
          "locations": [
            { "id": "loc_berlin_mitte", "name": "Berlin Mitte Store" }
          ]
        }
      }
    }
  }
}

interface SessionResult {
  sessionId: string;
  status:
    | 'pending'
    | 'authentication_required'
    | 'completed'
    | 'failed'
    | 'canceled'
    | 'expired';
  amount: number;
  currency: string;
  customer?: {
    customerId?: string;
    email?: string;
    name?: string;
  };
}

async function verifySession(sessionId: string): Promise<SessionResult> {
  const res = await fetch(
    `${process.env.INTENT_API_URL}/checkout/session/${sessionId}/result`,
    { headers: { 'X-Api-Key': process.env.VINR_API_KEY! } }
  );
  if (!res.ok) throw new Error(`Unexpected status ${res.status}`);
  return res.json();
}

const result = await verifySession(sessionId);

if (result.status === 'completed') {
  await fulfillOrder(result);
} else if (result.status === 'failed') {
  await notifyCustomerOfFailure(result);
} else if (result.status === 'expired') {
  await redirectToNewSession();
} else if (result.status === 'canceled') {
  await redirectToCart();
} else if (result.status === 'authentication_required') {
  // 3DS is still in progress — poll again shortly or wait for the webhook
}