moonpay-commerce

暗号資産で購入

目的

Solana Pay に対応した Shopify ストアを閲覧し、商品をカートに追加して、暗号資産で支払います。すべての操作は CLI から実行でき、ブラウザーは不要です。

コマンド

ストアを一覧表示

mp commerce store list

商品を検索

mp commerce product search --store <store> --query <search-term>

商品の詳細を取得

mp commerce product retrieve --store <store> --productId <product-id>

商品をカートに追加

mp commerce cart add \
  --store <store> \
  --variantId <variant-id> \
  --quantity <number> \
  --cartId <cart-id>  # omit to create a new cart

カートを表示

mp commerce cart retrieve --store <store> --cartId <cart-id>

カートから商品を削除

mp commerce cart remove --store <store> --cartId <cart-id> --lineId <line-id>

チェックアウトして支払う

mp commerce checkout \
  --wallet <wallet-name> \
  --store <store> \
  --cartId <cart-id> \
  --chain solana \
  --email <buyer-email> \
  --firstName <first> \
  --lastName <last> \
  --address <street-address> \
  --city <city> \
  --postalCode <zip> \
  --country <country-name>

操作例

1. ストアを閲覧：mp commerce store list
2. 検索：mp commerce product search --store ryder.id --query "ryder"
3. カートに追加：mp commerce cart add --store ryder.id --variantId "gid://shopify/ProductVariant/51751218774319" --quantity 1
4. カートを確認：mp commerce cart retrieve --store ryder.id --cartId <id-from-step-3>
5. チェックアウト：mp commerce checkout --wallet main --store ryder.id --cartId <id> --chain solana --email [email protected] --firstName John --lastName Doe --address "123 Main St" --city Amsterdam --postalCode 1011 --country Netherlands

仕組み

1. ストアは、閲覧とカート管理のための Shopify MCP エンドポイントを公開します
2. cart add はカートを作成または更新します（認証は不要で、カート ID を識別子として使用します）
3. checkout は API を呼び出して Helio 決済を開始し、トランザクションにローカルで署名して送信します
4. ガス代は Helio が負担するため、購入者が支払うのは商品の価格分の USDC のみです
5. トランザクション署名と注文確認 URL を返します

ヒント

• 異なる商品を追加するには cart add を複数回実行します。最初の呼び出しで返された --cartId を渡してください
• バリアント ID の検索には product search を使用します。各バリアントには Shopify GID があります
• --country フラグには国名の正式名称（例："United States"、"Netherlands"）を指定します
• チェックアウトには 30～90 秒かかります。API が Shopify のチェックアウトフローを自動化します
• 現在、支払いに対応しているのは Solana チェーンのみです

関連スキル

• moonpay-auth — 署名用のローカルウォレットを設定します
• moonpay-check-wallet — チェックアウト前に USDC 残高を確認します
• moonpay-swap-tokens — 支払い用の USDC を入手するためにトークンをスワップします