---
title: "長期トークン"
description: "KOMOJUのお客様オブジェクトを使って決済の詳細を長期保存する方法を説明します。サブスクリプションやカードオンファイル決済のユースケースに対応します。"
url: "https://docs.komoju.com/ja/docs/development/long-term-tokens"
source_url: "https://docs.komoju.com/ja/docs/development/long-term-tokens.md"
language: ja
last_modified: "2026-03-31"
---

この文書は、何回でも利用できる[決済の詳細](https://docs.komoju.com/ja/docs/integration-guides/payments-api-payment-details.md)の長期保存に関するものです。この機能のユースケースの一例として、独自のサブスクリプションエンジンを構築することが考えられます。

全体的なフローは次のようになります。

1. お客様の入力を収集する。
2. [お客様](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/subscriptions/POST/customers)オブジェクトを作成する。
3. 顧客IDをデータベースに保存する。
4. 将来、顧客IDを取得し、それを使用して[決済を作成する](https://docs.komoju.com/ja/docs/integration-guides/payments-api-overview.md)。

# お客様の入力を収集する

顧客の入力を収集する方法はいくつかあります。必要な具体的な入力は、標準の[決済の詳細](https://docs.komoju.com/ja/docs/integration-guides/payments-api-payment-details.md)オブジェクトです。

## 方法1: ホストされたページ

当社のホストされたページ製品には[「カスタマーモード」機能](https://docs.komoju.com/ja/docs/integration-guides/hosted-page-customer-mode.md)があり、お客様がKOMOJUで決済の詳細を入力すると、KOMOJUから顧客IDが渡されます。

これには、ほとんどのモバイルアプリの決済手段をサポートするという利点もあります。PayPay、またはPaidyの長期トークンを保存したい場合、現時点ではホストページのみが対応しています。

## 方法2: トークン

[お客様: 作成](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/subscriptions/POST/customers)を呼び出すときに、トークンID文字列を`payment_details`として渡すだけで、短期トークンを長期のお客様オブジェクトに「変換」できます。

```shell
curl -X POST https://komoju.com/api/v1/customers \
  --user sk_live_xxxxxxxxxxxxxxxx \
  --data payment_details='tok_donqjgn5pzgaeepqztogwdjdu'

```

これは、[ホストされたフィールドトークンモード](https://docs.komoju.com/ja/docs/integration-guides/hosted-fields-tokens-integration.md)を使用してトークンを収集できることも意味します。

## 方法3: 未加工の決済の詳細

[お客様:作成は](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/subscriptions/POST/customers)は、いつでも簡単に[決済の詳細と](https://docs.komoju.com/ja/docs/integration-guides/payments-api-payment-details.md)コールできます。クレジットカード番号でこれを行うと、PCI-DSSの対象となります。また、Komojuはクレジットカード情報を保存する前に、デフォルトでその情報を検証します。

# 顧客オブジェクトの使用

顧客IDを取得したら、それを使って決済をしたいと思うでしょう。現在、これは[ペイメント:作成](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/payments/POST/payments)エンドポイントでのみサポートされています。

お客様の決済詳細を使用して支払うには、`payment_details`要求パラメータを削除し、顧客IDと同じ`customer`パラメータを追加します。Paidy をサブスクリプションで利用したい場合は、Komoju のアカウントマネージャーまたはカスタマーサポートにご連絡いただき、承認を取得してください。

```shell
curl -X POST https://komoju.com/api/v1/payments \
  --user sk_live_xxxxxxxxxxxxxxxx \
  --data amount=5000 \
  --data currency=JPY \
  --data customer=boc2hxvmyl497eekihyrwmmgm

```