Crossmint

const result = await agent.methods.executeAction("CROSSMINT_CHECKOUT", {
  productLocator: "B08N5WRWNW",
  shippingAddress: {
    name: "John Doe",
    line1: "123 Main St",
    city: "New York",
    state: "NY",
    postalCode: "10001",
    country: "US"
  },
  userEmail: "john@example.com"
});

const confirmation = await agent.methods.executeAction("CROSSMINT_CONFIRM_ORDER", {
  orderId: "order_123",
  retryUptoConfirmation: true
});

interface CheckoutParams {
  productLocator: string;        // Amazon ASIN or product URL
  shippingAddress: {
    name: string;                // Recipient name
    line1: string;               // Address line 1
    line2?: string;              // Address line 2 (optional)
    city: string;                // City
    state: string;               // State (required for US)
    postalCode: string;          // Postal/ZIP code
    country: string;             // Country code (default: "US")
  };
  userEmail: string;             // User's email address
}

interface ConfirmOrderParams {
  orderId: string;               // Order ID to confirm
  retryUptoConfirmation?: boolean; // Retry until confirmation (default: false)
}

"Buy this Amazon product B08N5WRWNW and ship it to John Doe in New York"

"Order an Amazon item using USDC and confirm the purchase"

"Create a Crossmint order for Amazon product with shipping address"

"Check the status of my Crossmint order order_123"

"Confirm my Amazon order and retry until completion"

{
  "productLocator": "B08N5WRWNW",
  "shippingAddress": {
    "name": "John Doe",
    "line1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "userEmail": "john@example.com"
}

{
  "orderId": "order_abc123",
  "retryUptoConfirmation": true
}

// 1. Create order request
const orderData = {
  recipient: {
    email: userEmail,
    physicalAddress: shippingAddress
  },
  payment: {
    method: "solana",
    currency: "usdc",
    payerAddress: agent.wallet.publicKey.toBase58()
  },
  lineItems: [
    {
      productLocator: `amazon:${productLocator}`
    }
  ]
};

// 2. Submit to Crossmint API
const response = await fetch(`${CROSSMINT_PRODUCTION_API_URL}/orders`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-KEY": apiKey
  },
  body: JSON.stringify(orderData)
});

// 3. Sign and send transaction
const tx = VersionedTransaction.deserialize(bs58.decode(serializedTransaction));
const signedTx = await agent.wallet.signTransaction(tx);
const signature = await agent.connection.sendTransaction(signedTx);

// Poll for order completion
const pollInterval = setInterval(async () => {
  const order = await checkOrderStatus();
  
  if (order.payment.status === "completed") {
    clearInterval(pollInterval);
    return { success: true, status: "completed", order };
  }
}, 3000); // Poll every 3 seconds

// Timeout after 2 minutes
setTimeout(() => {
  clearInterval(pollInterval);
  return { success: false, error: "Payment confirmation timeout" };
}, 120000);

const shippingAddress = {
  name: "John Doe",           // Required
  line1: "123 Main St",       // Required
  line2: "Apt 4B",           // Optional
  city: "New York",          // Required
  state: "NY",               // Required for US
  postalCode: "10001",       // Required
  country: "US"              // Required
};

try {
  const result = await agent.methods.executeAction("CROSSMINT_CHECKOUT", {
    productLocator,
    shippingAddress,
    userEmail
  });
} catch (error) {
  if (error.message.includes("CROSSMINT_API_KEY")) {
    // Handle missing API key
  } else if (error.message.includes("insufficient funds")) {
    // Handle insufficient USDC balance
  } else if (error.message.includes("invalid address")) {
    // Handle shipping address validation errors
  }
}

{
  status: "success",
  order: {
    orderId: "order_abc123",
    phase: "payment",
    quote: {
      totalPrice: {
        amount: "29.99",
        currency: "usdc"
      }
    },
    payment: {
      status: "completed",
      method: "solana",
      currency: "usdc"
    }
  },
  message: "Order created successfully",
  signature: "5UfgJ5vVZxUxefDGqzqkVLHzHxVTyYH9StYyHKgvHYmXJgqJKxEqy9k4Rz9LpXrHF9kUZB7"
}

{
  status: "success",
  order: {
    orderId: "order_abc123",
    payment: {
      status: "completed"
    },
    delivery: {
      status: "in-progress"
    }
  },
  message: "Order confirmed successfully"
}

{
  status: "error",
  message: "CROSSMINT_API_KEY is not set in agent config"
}

const agent = new SolanaAgentKit(
  wallet,
  "YOUR_RPC_URL",
  {
    OTHER_API_KEYS: {
      CROSSMINT_API_KEY: "your-crossmint-api-key"
    }
  }
);

// Production
const CROSSMINT_PRODUCTION_API_URL = "https://www.crossmint.com/api/2022-06-09";

// Staging
const CROSSMINT_STAGING_API_URL = "https://staging.crossmint.com/api/2022-06-09";

// Use ASIN (Amazon Standard Identification Number)
productLocator: "B08N5WRWNW"

// Or full Amazon URL
productLocator: "https://www.amazon.com/dp/B08N5WRWNW"

// Use URL with variant ID
productLocator: "shopify:https://store.com/product:variant-id"