---
title: "実装ガイド: カスタマー"
description: "トークン化された支払い情報を集めましょう"
url: "https://docs.komoju.com/ja/docs/integration-guides/hosted-page-customer-mode"
source_url: "https://docs.komoju.com/ja/docs/integration-guides/hosted-page-customer-mode.md"
language: ja
last_modified: "2026-03-31"
---

ペイメントだけでなく、ホストページはカスタマーを作成することも出来ます。[カスタマー](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/subscriptions/POST/customers)とは長期的に顧客の支払い情報を保存するリソースです。

# 1: mode=customerを指摘してセッションを作成

セッションを作成する際には、ペイメントモードがデフォルトになっていますが、`"mode": "customer"`を指定するとペイメントの代わりにカスタマーリソースが作成されます。

カスタマーモードで作成されたセッションには`customer_id`が含まれています。この`customer_id`を保存いただくことで、後にペイメントを作る時に`payment_details`の代わりに`customer_id`を使うことが出来ます。

ペイメントモードと同様に、セッションを作成したあと顧客を`session_url`にリダイレクトさせます。

# 2: customer.updated webhookを受信

Step 1で`customer_id`を得られましたが、顧客がセッションを完了させるまでこれを使用することはできません。`customer_id`が利用できるようになると、`customer.updated`というwebhookが送信されます。webhookについては、[webhook](https://docs.komoju.com/ja/docs/introduction/webhooks.md)のドキュメントをご参考ください。

# 3: `customer_id`を使用してペイメントを作成

`customer_id`が利用可能になると、これを使ってペイメントを作成できます。ペイメントを作成するAPIで`payment_details`の代わりに`customer`を渡します。