Actions6
- Wallet Actions
- Checkout Actions
Overview
The "Create Order" operation in the Checkout resource enables users to search for a product on Amazon or Shopify and create an order for it using Crossmint's hybrid payment integration. This node facilitates purchasing physical products by specifying recipient details and payment information, including cryptocurrency payments via supported blockchain networks.
Typical use cases include:
- Automating e-commerce purchases where the product is identified by an Amazon ASIN or Shopify product URL.
- Sending gifts directly to recipients with full address and contact details.
- Paying for orders using crypto wallets managed by Crossmint, supporting testnet and mainnet environments.
For example, a user can input an Amazon product ASIN, specify the recipient's shipping address and email, select a payment chain like Ethereum mainnet, and pay with USDC tokens from a Crossmint-managed wallet.
Properties
| Name | Meaning |
|---|---|
| Platform | E-commerce platform to purchase from. Options: "Amazon" (Amazon marketplace), "Shopify" (Shopify store). |
| Product Identifier | Identifier of the product to buy. For Amazon, this is the ASIN (e.g., B01DFKC2SO) or full Amazon product URL. For Shopify, this is the full product URL (default variant used). |
| Recipient Email | Email address of the person receiving the product. Must be a valid email format. |
| Recipient Name | Full name of the recipient who will receive the product. |
| Address Line 1 | Primary street address, P.O. box, company name, or care-of information for shipping. |
| Address Line 2 | Optional secondary address line such as apartment, suite, unit, building, or floor. |
| City | City, district, suburb, town, or village for the shipping address. |
| State | US state code (required). |
| ZIP Code | Postal or ZIP code for the shipping address. |
| Country | Two-letter country code (ISO 3166-1 alpha-2). Currently only "United States" (US) is supported. |
| Environment | Environment for payment methods. Options: "Staging (Testnet)" for testing on testnets, "Production (Mainnet)" for real transactions on mainnets. |
| Payment Chain | Blockchain network used for payment. Options depend on environment: - Staging: Arbitrum Sepolia, Base Sepolia, Ethereum Sepolia, Optimism Sepolia, Polygon Amoy, World Chain Sepolia. - Production: Arbitrum, Base, Ethereum, Optimism, Polygon. |
| Payment Currency | Cryptocurrency to pay with. Only "USDC" (USD Coin) is supported. |
| Payer Wallet Address | Crypto wallet address that will fund the payment. Must be a Crossmint-managed wallet with sufficient USDC funds. |
Output
The output JSON contains the response from the Crossmint API after creating the order. It includes detailed order information such as:
- Order ID and status.
- Payment preparation details including serialized transaction data.
- Recipient and shipping address confirmation.
- Line items with product locators.
- Receipt email and payment method details.
This output can be used to track the order status or to proceed with payment execution if needed.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for Crossmint API access.
- The node makes HTTP requests to either the production or staging Crossmint API endpoints depending on the selected environment.
- The payer wallet must be a Crossmint-managed wallet funded with USDC tokens on the specified blockchain network.
- Network connectivity to Crossmint API endpoints is required.
Troubleshooting
- Missing or invalid product identifier: Ensure the ASIN or Shopify product URL is correctly provided; otherwise, the node throws an error indicating the missing or invalid product identifier.
- Invalid recipient email: The email must contain an "@" symbol; otherwise, an error about invalid email address is thrown.
- Incomplete shipping address: Required fields like recipient name, address line 1, city, postal code, and state must be filled; missing any causes errors.
- Unsupported country: Currently, only "US" is supported; other country codes may cause failures.
- Payment wallet issues: The payer wallet address must be a valid Crossmint-managed wallet with sufficient USDC balance; otherwise, payment will fail.
- API errors: Network issues or invalid API keys result in API errors returned from Crossmint, surfaced as node errors.
- Environment mismatch: Using a payment chain incompatible with the selected environment (staging vs production) may cause errors.
To resolve errors, verify all required inputs, ensure correct environment and payment chain selection, and confirm the payer wallet has adequate funds.