チェックアウト

チェックアウトの使い方を学び、ウェブサイトで支払いを受け取りましょう。

Tokenz チェックアウトは、オンラインで支払いを安全に受け取ることができる事前構築された支払いフォームです。既に機能が組み込まれているため、開発時間を短縮することができます。顧客をホストする支払いページにリダイレクトすることで、支払いを受け取ることができます。

チェックアウトはカスタマイズすることができ、Checkout Session API (チェックアウトセッション API) を使って追加機能にアクセスすることができます。

金額フォーマット： すべての金額値（amount フィールドなど）は各通貨の最小単位で表現されます。通貨ごとの正確なエンコーディングについては、サポートされている通貨を参照してください。

統合を始める

AI エージェントに任せる

Claude Code・Cursor・Codex を Tokenz の MCP に接続すると、テストモードの統合を自動で実装します。あとはレビューして公開するだけです。

claude mcp add --transport http tokenz https://mcp.tokenz.one/mcp --header "Authorization: Bearer secret_test_YOUR_KEY_HERE"

AI で始める

自分で統合する

クイックスタートに従って、Checkout セッションを作成し、ホスト型ページにリダイレクトし、webhook を処理します。

クイックスタートを開く

チェックアウトのライフサイクル

お客様がウェブサイトで商品を選択し、チェックアウトをクリックします。
サーバーが Tokenz API を使って新しい Checkout Session を作成します。
Tokenz API が Checkout Session を返します。
サーバーがお客様を Tokenz がホストする支払いページにリダイレクトします。
お客様が Tokenz がホストする支払いページで支払いを完了します。
Tokenz がお客様をウェブサイトにリダイレクトします。
Tokenz がサーバーに Webhook イベントを送信します。
サーバーが order.succeeded イベントを使って注文を履行します。

図

Checkout Session

Checkout Session (チェックアウトセッション) とは、支払いフォームでお客様に表示される内容をプログラムで表現したものです。 Checkout Session の作成後、購入を完了するためにお客様を url にリダイレクトします。お客様が購入を完了したら、注文イベントに Webhook を設定すると注文を履行することができます。以下の例は、Checkout Session の作成方法を示しています。

bash

curl --request POST \
  --url https://api.tokenz.one/v2/checkoutsession \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer secret_test_YOUR_KEY_HERE' \
  --data '{
    "itemDetails": [
      {
        "product": {
          "price": {
            "amount": 1000,
            "currency": "JPY"
          },
          "images": [
            "https://images.ctfassets.net/z82qbo7cv7ia/6LaDyyNBQ5Sqd1THQYxksI/ff5bce84e3864a4f826f5aed0822bd10/treasure-chest-1.png"
          ],
          "quantity": 1,
          "label": "Treasure Chest",
          "taxCategory": "DIGITAL_GOODS_AND_SERVICES"
        }
      }
    ],
    "successUrl": "https://example.com/success",
    "pendingUrl": "https://example.com/pending",
    "cancelUrl": "https://example.com/cancel",
    "customerInfo": {}
  }'

注文合計は常に itemDetails の価格から計算されます。一部の例にあるトップレベルの amount フィールドは任意ですが、指定する場合は itemDetails の合計と一致している必要があり、一致しない場合はリクエストが拒否されます。

税区分

適切な税計算とコンプライアンスのため、チェックアウトセッションの各商品には taxCategory フィールドを含める必要があります。以下の区分がサポートされています：

VIRTUAL_CURRENCY: ゲーム内通貨、トークン、または仮想コイン
DIGITAL_GOODS_AND_SERVICES: ゲームアイテム、ダウンロードコンテンツ、デジタルサービスなどのデジタル製品
EBOOK: 電子書籍および出版物
SAAS: Software as a Service サブスクリプション

正確な税処理を確保するため、商品タイプに最も適した区分を選択してください。

支払い方法

ホストする支払いページでお客様に提供する支払い方法をカスタマイズすることができます。サポートされている1つまたは複数のオプションを paymentMethodKinds 引数に送信すると、お客様が利用できる支払い方法を指定できます。引数が含まれていない場合や、空のリストが送信された場合は、サポートされているすべての支払い方法が表示されます。