Checkout

const result = await sdk.checkout.create();

if (result.type === 'free_order') {
  // No payment needed — order is created immediately
  console.log('Order created:', result.order_id);
} else if (result.type === 'payment_required') {
  // Redirect the customer to the payment page
  window.location.href = result.checkout_url;
}

{
  type: 'free_order' | 'payment_required';
  checkout_id?: string;       // Payment session ID
  checkout_url?: string;      // URL to redirect customer to
  order_id?: number;          // Order ID (for free orders)
  amount?: number;            // Payment amount
  redirect_url?: string;      // Post-payment redirect URL
}

const { status, order } = await sdk.checkout.getResult(sessionId);

if (status === 'completed') {
  console.log('Payment successful! Order:', order.id);
} else {
  console.log('Payment status:', status);
}

{
  status: string;    // e.g., 'completed', 'pending', 'failed'
  order?: Order;     // The created order (if completed)
}

// 1. Validate the cart
const validation = await sdk.cart.validate();
if (!validation.valid) {
  throw new Error('Cart validation failed: ' + validation.errors?.join(', '));
}

// 2. Create checkout session
const result = await sdk.checkout.create();

// 3. Handle the result
switch (result.type) {
  case 'free_order':
    // Navigate to order confirmation
    router.push(`/orders/${result.order_id}`);
    break;

  case 'payment_required':
    // Redirect to payment gateway
    window.location.href = result.checkout_url!;
    break;
}

// 4. On the return/callback page, check the result
const sessionId = new URLSearchParams(window.location.search).get('session_id');
if (sessionId) {
  const { status, order } = await sdk.checkout.getResult(sessionId);
  if (status === 'completed') {
    // Show success page
  }
}