Actions7
- Wallet Actions
- Checkout Actions
Overview
The node enables creating an order on e-commerce platforms (Amazon or Shopify) and preparing it for payment using cryptocurrency via Crossmint's API. It supports specifying product details, recipient shipping information, and payment parameters including blockchain network and wallet addresses.
Typical use cases include:
- Automating product purchases from Amazon or Shopify stores.
- Integrating crypto payments (USDC) on various testnet or mainnet blockchains.
- Sending gifts or orders directly to recipients with full address and contact info.
- Using Crossmint-managed wallets to handle crypto payments securely.
Example: Automatically create an Amazon order for a specific ASIN, specify the recipient's shipping address, and prepare the order for payment on Ethereum mainnet using USDC.
Properties
| Name | Meaning |
|---|---|
| Platform | E-commerce platform to purchase from. Options: Amazon, Shopify. |
| Product Identifier | For Amazon: ASIN code or full product URL (e.g., B01DFKC2SO or https://www.amazon.com/dp/B01DFKC2SO). For Shopify: 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. |
| Address Line 2 (Optional) | Secondary address line such as apartment, suite, unit, building, or floor. |
| City | City, district, suburb, town, or village of the recipient's address. |
| State | US state abbreviation (required). |
| ZIP Code | Postal or ZIP code of the recipient's address. |
| Country | Two-letter country code (ISO 3166-1 alpha-2). Only "United States" (US) is supported. |
| Environment | Blockchain environment for payment: Staging (Testnet) or Production (Mainnet). |
| Payment Chain | Blockchain network to use 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. Currently only USDC (USD Coin) is supported. |
| Payer Wallet Address | Wallet address that will pay for the order in crypto. Must be a Crossmint-managed wallet funded with USDC. |
Output
The node outputs JSON data representing the created order and its payment preparation details. The structure includes:
- Order details such as recipient info, shipping address, and product locator.
- Payment method and currency.
- A serialized transaction or payment instructions prepared for the specified blockchain.
- Metadata about the order status and identifiers.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for Crossmint's API.
- Network access to Crossmint's production or staging API endpoints.
- The payer wallet must be managed by Crossmint and pre-funded with USDC tokens on the selected blockchain.
- Crypto private keys are required for signing transactions when completing payments (not for order creation).
Troubleshooting
- Missing or invalid product identifier: Ensure the ASIN or Shopify product URL is correctly provided.
- Invalid recipient email: Must be a valid email format; otherwise, the node throws an error.
- Incomplete shipping address: Required fields like address line 1, city, state, postal code, and country must be filled.
- Unsupported country: Only US addresses are supported currently.
- Payment chain mismatch: Choose a payment chain compatible with the selected environment (staging vs production).
- Payer wallet issues: The payer wallet address must be a Crossmint-managed wallet with sufficient USDC funds.
- API errors: Network or authentication errors from Crossmint API will be surfaced as node errors.
- Private key requirements: For payment operations (not order creation), a valid private key matching the blockchain type is mandatory.