カート／チェックアウトのパーマリンクが UCP 対応 リンク 1 本で「カート投入 → 情報入力 → チェックアウト」まで進める新ルート /buy

図解 ： カート／チェックアウトのパーマリンクが UCP の /buy に対応 Developer Changelog / UCP・チェックアウト カート／チェックアウトのパーマリンクが UCP 対応 リンク 1 本で「カート投入 → 情報入力 → チェックアウト」まで進める新ルート /buy UCP 2026-08-25 から、Shopify ストアフロントは dev.ucp.shopping.permalink ケイパビリティに対応。 /buy リンクは UCP 対応ストアならどこでも同じ書式で使える。既存の /cart リンクも引き続き動く。 このページの構成 そもそも何が変わるのか（30秒で理解） 仕組み図解 ： リンクを作ってから購入者が着地するまで /buy リンクの構造 /buy リンクでできること /buy と /cart の比較 移行の進め方（3ステップ） 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 そもそも何が変わるのか Shopify ストアフロントに新しいルート /buy が追加された。UCP（2026-08-25 以降）の dev.ucp.shopping.permalink ケイパビリティに対応するルート。 リンク 1 本で 商品のカート投入・チェックアウト情報の事前入力・チェックアウトへの遷移 までをまとめて行え、 UCP 対応ストアならどこでも同じ書式 で使える。 これまで ： /cart パーマリンク 今後は「レガシー形式」扱い。引き続きサポートされ動作するが、新しい機能は追加されない。 これから ： /buy パーマリンク UCP 標準の書式。新しい機能は /buy にだけ追加される。UCP 対応ストア間で共通の書式。 既存のインテグレーションは変更不要 で引き続き動作する。移行は自分のペースで進められる。 2 仕組み図解 ： リンクを作ってから購入者が着地するまで /buy の URL を自分で組み立てない。 ストアのディスカバリプロファイル（ /.well-known/ucp ）から config.endpoint を読み、それをベースにリンクを作るのが公式の推奨。 3 /buy リンクの構造 パス 商品は token:quantity のペア 1 つ以上の商品をバリアント ID で追加できる。token が具体的にどの形式の ID を取るかの詳細は本文に記載なし（仕様ドキュメント参照）。 クエリ パラメータ名は UCP フィールドパス 例として buyer/email 、 discounts/codes/0 が挙げられている。それ以外の項目（国・言語・Shop Pay など）の具体的なパラメータ名は本文に記載なし。 4 /buy リンクでできること 商品をカートに追加 バリアント ID で 1 点〜複数点を指定。 購入者情報を事前入力 メールアドレスなどの購入者の詳細を事前に入力。 国と言語を指定 購入者の国・言語を設定できる。 割引コードを適用 例 ： discounts/codes/0 のようなフィールドパスで指定。 Shop Pay を優先する意向を示す Shop Pay を好むことをリンクで示せる。 指定ページへ送る continue_to パラメータでストア内の特定ページに遷移させる。 5 /buy と /cart の比較 項目 /cart（レガシー） /buy（UCP） 位置づけ レガシー形式 引き続きサポート 推奨 新規リンクはこちら 新機能の追加 追加されない /buy にのみ追加 ストア横断の互換性 記載なし 共通 UCP 対応ストアなら同じ書式 販売プラン（selling plans） 使える 未対応 ラインアイテムプロパティ 使える 未対応 カートメモ／カート属性 使える 未対応 適用できなかったとき 記載なし continue_to 先、なければストアフロントへリダイレクト（エラーページなし） 定期購入（販売プラン）・ラインアイテムプロパティ・カートメモ・カート属性 のどれかに依存しているなら、現時点では /cart を使い続ける。/buy がこれらにいつ対応するかは記載なし。 6 移行の進め方（3ステップ） 1 既存の /cart リンクを棚卸し 販売プラン・ラインアイテムプロパティ・カートメモ・カート属性を使っているリンクは /cart のまま残す。 2 config.endpoint からリンクを組立 新規リンクは /buy で作る。URL は手で組まず、ディスカバリプロファイルの値を読む。 3 置き換えられるものから /buy へ /cart も動き続けるので、自分のスケジュールで段階的に移行すればよい。 一括で切り替える必要はない。 新しく作るリンクから /buy にしていけば、既存の導線は止まらない。 7 技術者が押さえるべき5つのポイント 1. URL はハードコードしない /.well-known/ucp のディスカバリプロファイルから dev.ucp.shopping.permalink の config.endpoint を読み、それを起点にリンクを作る。 /buy を決め打ちで組み立てないこと。 2. ケイパビリティネゴシエーションは不要 パーマリンクはネゴシエーションを使わない。エージェントプロファイルで dev.ucp.shopping.permalink を宣言する必要はない。 3. クエリ名は UCP フィールドパス buyer/email 、 discounts/codes/0 のようにスラッシュ区切りのパスで指定し、配列はインデックスで表す。商品は別系統でパスの token:quantity に入れる。 4. 失敗時はエラーページではなくリダイレクト 適用できないリンクは continue_to 先、なければストアフロントへ送られる。購入者に壊れたページは見えないが、 適用に失敗したことに気付きにくい 点は意識しておく。 5. リンクに機密情報を入れない 決済情報やアクセストークンは絶対にリンクに入れない。 広く共有するリンク（SNS・メルマガ・広告など）には、メールアドレスなどの購入者の個人情報も入れないようにする。 8 業務に活かせる3つのユースケース USE CASE 1 AI エージェント／外部チャネルからの「どのストアでも同じ」購入リンク生成 課題 複数のストアに送客するエージェントや比較サービスで、ストアごとにカートリンクの作り方を実装・保守している。 打ち手 各ストアの /.well-known/ucp から config.endpoint を取得し、共通書式の /buy リンクを生成する実装に一本化する。 効果 UCP 対応ストアなら同じロジックで動くため、ストア別の分岐が減り、購入者をチェックアウトまで直接案内できる。 技術メモ ケイパビリティネゴシエーション不要なので、エージェントプロファイルに permalink を宣言しなくてよい。リンクには決済情報・トークンを含めない。 USE CASE 2 メルマガ・LINE 配信で「割引コード適用済みカート」に直送 課題 キャンペーンでクーポンを配っても、購入者がカート投入やコード入力の途中で離脱する。 打ち手 /buy リンクに対象商品（token:quantity）と discounts/codes/0 を入れ、国・言語や Shop Pay の優先も指定して配信する。 効果 クリック 1 回で商品投入・コード適用・チェックアウト到達まで進むため、手順の途中での離脱を減らせる。 技術メモ 一斉配信リンクには buyer/email 等の個人情報を入れない。適用できない場合に備え、 continue_to でキャンペーン LP へ戻す設計にしておく。 USE CASE 3 既存ストアのパーマリンク棚卸しと段階移行 課題 広告・QR コード・SNS・ブログなどに /cart リンクが散らばっていて、今後の新機能の恩恵を受けられない。 打ち手 リンクを一覧化し、販売プラン・ラインアイテムプロパティ・カートメモ・カート属性を使わないものから /buy に置き換える。使うものは /cart のまま残す。 効果 既存の導線を止めずに、新機能が追加される /buy 側へ寄せていける。 技術メモ 定期購入（販売プラン）を扱うストアは現時点で /cart が必須。印刷済み QR など差し替えにくい媒体は /cart のまま動き続けるので急がなくてよい。 9 提案で使える1行サマリ 「リンク 1 本で商品投入・情報の事前入力・割引適用を済ませてチェックアウトへ直行できる、UCP 共通書式の /buy パーマリンク。 新規リンクは /buy、定期購入やカート属性が要るものは当面 /cart 、既存リンクはそのまま動くので急がず移行すればよい。」 source ： shopify.dev / changelog / cart-and-checkout-permalinks-now-support-ucp-at-buy 元記事公開日 2026-10-28