---
title: 購入リンク
description: 商品ごとに1本ある、購入画面を開くための URL。
---

購入リンクは購入画面を開くための URL です。商品ごとに1本あり、商品を作ると同時に作られます。自分のサイトにはこの購入リンクを置きます。

## しくみ

商品を作ってから、お客様の注文ができるまでは、次の順に進みます。

1. **商品を作ると、購入リンクができる**

    商品を作ると、標準の購入リンクが1本作られます。URL は `/checkout/` で始まり、商品ごとの識別子が続きます。

2. **お客様が購入リンクを開く**

    購入リンクを開くと、購入画面が開きます。

3. **お客様が支払う**

    お客様はメールアドレスを入力し、カードで支払います。

4. **注文ができる**

    支払いが終わると、注文が1件できます。詳しくは [注文](/features/orders) を参照してください。

商品をアーカイブすると、その購入リンクでの新規購入が止まります。既存のお客様の閲覧は続きます。アーカイブした商品の購入リンクをお客様が開くと、「このページは開けません」と「この商品の販売は終了しています。」が表示されます。

販売の準備（審査の承認と売上の受け取り先の登録）が済むまでは、購入リンクを開いても「この商品は現在購入できません」と表示され、お客様は購入できません。管理画面の商品詳細にも「アカウントの審査が完了するまで、このリンクでは購入できません」と表示されます。

:::note
機能フラグの商品では、商品詳細に購入リンクの3つのタブを表示しません。商品一覧の「チェックアウトURLをコピー」は使えます。機能フラグの商品はアプリのサーバーで購入画面を作って売ります。詳しくは [購入画面の API](/features/checkout/session) を参照してください。
:::

## サイトに置く

管理画面の商品詳細には、購入リンクを確認するための3つのタブがあります。

- 「リンク」：自分のサイトに置く購入リンクの URL です。
- 「HTMLタグ」：そのまま貼れる HTML のリンクです。見た目はサイト側で調整します。
- 「プロダクトID」：SDK の設定に使う商品IDです。購入者限定ページの保護に必要です。

購入リンクの例は次のとおりです。

```html 購入リンク
<a href="（管理画面の「リンク」タブの URL）">購入する</a>
```

## API で扱う

購入リンクは外部 API で取得と発行ができます。

- 取得：`GET /products/{product_id}/checkout-link`（スコープは `checkout_links:read`）。購入リンクが発行されていなければ 404 になります。無効なリンクは `disabled: true` で返ります。
- 発行：`PUT /products/{product_id}/checkout-link`（スコープは `checkout_links:write`）。リンクが新しく作られたときは 201、既存のリンクを返したときは 200 です。

発行では、商品がアーカイブ済みのとき（`product_archived`）と、既存の標準リンクが無効なとき（`checkout_link_disabled`）は 409 になります。Cozeni が別のリンクを作ったり、無効なリンクを有効に戻したりすることはありません。

API の詳細は次を参照してください。

- [購入リンクの取得](/api-reference/checkout-links/external-get-checkout-link)
- [購入リンクの発行](/api-reference/checkout-links/external-ensure-checkout-link)

## 次に読むページ

**[商品](/features/products)**

販売するものと価格を登録する。

**[購入画面の API](/features/checkout/session)**

メールアドレスを固定した購入画面を、サーバーから作る。

**[支払い方法](/features/checkout/payment-methods)**

購入画面で使える支払い方法。

**[注文](/features/orders)**

お客様の支払い1回分の記録。
