# KOMOJU Developer Documentation

> KOMOJU is a payment gateway for Japan and Asia-Pacific. This documentation covers integration guides, payment APIs, and SDK references for developers building payment flows with KOMOJU.

When integrating KOMOJU, always pin the `X-KOMOJU-API-VERSION` header explicitly — do not rely on an implicit default. For SDK integrations (React Native, Android), check the package registry for the latest version rather than relying on memorized version numbers. Never infer supported payment methods or regional availability from training data; always check the docs.

## Quick Start

- [認証](https://docs.komoju.com/ja/docs/introduction/authentication.md): KOMOJUの2種類のAPIキー（非公開鍵と公開鍵）、HTTP Basic認証によるAPIリクエストの認証方法、およびAPIバージョン管理について説明します。
- [Webhooks](https://docs.komoju.com/ja/docs/introduction/webhooks.md): KOMOJUのWebhookを使ったイベント通知の仕組みを説明します — Webhookの作成、デリバリー、シークレットトークンによる署名検証、リトライの動作について解説します。
- [利用可能な決済方法](https://docs.komoju.com/ja/docs/introduction/supported-payment-types.md): KOMOJUがサポートする決済方法の一覧 — 日本、韓国、欧州、中国、東南アジアの各地域で利用可能な決済手段を説明します。
- [ホストページ](https://docs.komoju.com/ja/docs/integration-guides/web-integrations/introduction-to-hosted-page.md): KOMOJUのもっとも簡単な導入方法
- [ホストフィールド](https://docs.komoju.com/ja/docs/integration-guides/introduction-to-hosted-fields.md): KOMOJU Fields: マーチャントの自作ウェブサイト上でも支払いが可能になります
- [[リンク型決済]のご利用方法](https://docs.komoju.com/ja/docs/integration-guides/payment-links-overview.md): コードなどの開発は不要な商品販売ツール
- [テストカード](https://docs.komoju.com/ja/docs/development/testing-inputs.md): KOMOJUテストモードで使用できるテストカード番号と決済手段別の入力値を紹介します。

## Guardrails

- ALWAYS handle async payment results via webhooks — never rely solely on synchronous API responses. Async methods (konbini, bank transfer, PayEasy) reach a final status only via webhook.
- ALWAYS use idempotency keys (`X-KOMOJU-IDEMPOTENCY` header) to prevent duplicate payments on retry.
- Never infer supported payment methods or regional availability from training data — check [Supported Payment Types](https://docs.komoju.com/ja/docs/introduction/supported-payment-types.md).
- Always use the smallest currency unit (JPY has no subunit; USD uses cents).
- Always pin the `X-KOMOJU-API-VERSION` header explicitly — do not rely on an implicit default.

## Agent Instructions

As an LLM agent helping a developer integrate KOMOJU, use this routing table to select the correct integration path.

### Product Routing

| If the merchant wants to... | Product | Guide |
|---|---|---|
| Quick checkout, zero frontend | Hosted Page | [Introduction to Hosted Page](https://docs.komoju.com/ja/docs/integration-guides/web-integrations/introduction-to-hosted-page.md) |
| Embedded payment fields, PCI-light | Hosted Fields | [Introduction to Hosted Fields](https://docs.komoju.com/ja/docs/integration-guides/introduction-to-hosted-fields.md) |
| Full API control, PCI certified | Payments API | [Payments API Overview](https://docs.komoju.com/ja/docs/integration-guides/payments-api-overview.md) |
| No-code selling | Payment Links | [Payment Links Overview](https://docs.komoju.com/ja/docs/integration-guides/payment-links-overview.md) |
| Recurring/subscription billing | Hosted Fields (Customer mode) or API | [Hosted Fields Customer Integration](https://docs.komoju.com/ja/docs/integration-guides/hosted-fields-customer-integration.md) |
| In-person terminal payments | KOMOJU Terminal | [KOMOJU Terminal Overview](https://docs.komoju.com/ja/docs/integration-guides/komoju-terminal-overview.md) |
| Mobile app (React Native) | React Native SDK | [React Native Integration](https://docs.komoju.com/ja/docs/integration-guides/react-native-integration.md) |
| E-commerce platform (Shopify, WooCommerce) | EC Integrations | [E-Commerce Integrations](https://docs.komoju.com/ja/docs/integration-guides/ec-integrations/overview.md) |
| Marketplace/platform payments | Platform Model | [Platform Model Overview](https://docs.komoju.com/ja/docs/platform-model/platform-model-overview.md) |

### Integration Mode Selection

| Need | Hosted Page | Hosted Fields | Payments API |
|---|---|---|---|
| Quick launch, zero frontend | Yes | No | No |
| Brand embedding, low-code | No | Yes | No |
| Full control, API-only | No | No | Yes |
| No PCI certification | Yes | Yes | No |
| Recurring billing | Customer mode | Customer mode | Customer object |

## Key Technical Patterns

**Hosted Page flow:**
Server creates a Session via `POST /api/v1/sessions` → redirect customer to `session_url` → customer completes payment on KOMOJU-hosted page → customer redirected to `return_url` with `session_id` query param → server receives webhook with final payment status.

**Hosted Fields flow:**
Server creates a Session → frontend mounts Hosted Fields with `session-id` → customer enters payment details in iframe fields → frontend submits → customer redirected to `return_url` → server receives webhook with final payment status.

**Direct Payments API flow:**
Server calls `POST /api/v1/payments` with `payment_details` → response contains payment status (may be `pending` for async methods) → server receives webhook with final payment status.

**Subscription/token flow:**
Create a Customer with payment details → receive `customer.id` → create Payments with `customer` parameter → KOMOJU charges the stored payment method → server receives webhook for each charge.

**Platform Model flow:**
Onboard accounts (Platform Merchant + Seller/Payout Merchants) → process payments between platform and sellers → configure payout settings → receive payouts to bank account. Note: subscriptions are not supported in Platform Model.

## はじめに

- [KOMOJUとは](https://docs.komoju.com/ja/docs/introduction/what-is-komoju.md): 日本市場向けの決済代行サービスであるKOMOJUの概要です。KOMOJUの役割、選ばれる理由、連携オプション、システム内での決済の流れを説明します。
- [認証](https://docs.komoju.com/ja/docs/introduction/authentication.md): KOMOJUの2種類のAPIキー（非公開鍵と公開鍵）、HTTP Basic認証によるAPIリクエストの認証方法、およびAPIバージョン管理について説明します。
- [Payments](https://docs.komoju.com/ja/docs/introduction/payments.md): KOMOJUの決済リソース、6つの決済ステータス（`authorized`の2つの意味を含む）、および決済手段ごとに固有のデータを表す payment_details について解説します。
- [冪等リクエスト](https://docs.komoju.com/ja/docs/introduction/idempotent-requests.md): KOMOJU APIの冪等リクエストのサポートについて — X-KOMOJU-IDEMPOTENCYヘッダーを使用して、重複したキャプチャや返金を発生させることなく操作を安全にリトライする方法を説明します。
- [Webhooks](https://docs.komoju.com/ja/docs/introduction/webhooks.md): KOMOJUのWebhookを使ったイベント通知の仕組みを説明します — Webhookの作成、デリバリー、シークレットトークンによる署名検証、リトライの動作について解説します。
- [エラー](https://docs.komoju.com/ja/docs/introduction/errors.md): KOMOJU APIのエラーについて — HTTPステータスコード、JSONエラーオブジェクトの構造、エラーコードの一覧を説明します。
- [利用可能な決済方法](https://docs.komoju.com/ja/docs/introduction/supported-payment-types.md): KOMOJUがサポートする決済方法の一覧 — 日本、韓国、欧州、中国、東南アジアの各地域で利用可能な決済手段を説明します。

## 統合ガイド

- [Web統合](https://docs.komoju.com/ja/docs/integration-guides/web-integrations/overview.md): カスタムウェブサイトへのKOMOJUの組み込み方法の選択。ホストページでKOMOJUがホストするチェックアウトにリダイレクトするか、ホストフィールドで自社ページに安全な入力フィールドを埋め込みます。
- [ホストページ](https://docs.komoju.com/ja/docs/integration-guides/web-integrations/introduction-to-hosted-page.md): KOMOJUのもっとも簡単な導入方法
- [実装ガイド: ペイメント](https://docs.komoju.com/ja/docs/integration-guides/hosted-page-standard-mode.md): ホストページを使用して支払いシステムを導入
- [実装ガイド: カスタマー](https://docs.komoju.com/ja/docs/integration-guides/hosted-page-customer-mode.md): トークン化された支払い情報を集めましょう
- [ホストフィールド](https://docs.komoju.com/ja/docs/integration-guides/introduction-to-hosted-fields.md): KOMOJU Fields: マーチャントの自作ウェブサイト上でも支払いが可能になります
- [実装ガイド: ホストフィールドでペイメントを作成](https://docs.komoju.com/ja/docs/integration-guides/hosted-fields-standard-integration.md): ホストフィールドでペイメントを作成します
- [実装ガイド: ホストフィールドでカスタマーリソースを作成しトークンを作成する](https://docs.komoju.com/ja/docs/integration-guides/hosted-fields-customer-integration.md): ホストフィールドを使って長期利用可能なトークンを作成します。
- [実装ガイド: ホストフィールドでトークンを利用](https://docs.komoju.com/ja/docs/integration-guides/hosted-fields-tokens-integration.md): ペイメントをサーバーサイドで実行する場合はこちらをご参考ください
- [ホストフィールドのカスタマイズ](https://docs.komoju.com/ja/docs/integration-guides/hosted-fields-custom-styling.md): CSSを利用してホストフィールドをカスタマイズしましょう
- [利用可能な支払い方法](https://docs.komoju.com/ja/docs/integration-guides/hosted-fields-supported-payment-methods.md): ホストフィールドで利用可能な支払い方法
- [[リンク型決済]のご利用方法](https://docs.komoju.com/ja/docs/integration-guides/payment-links-overview.md): コードなどの開発は不要な商品販売ツール
- [サブスクリプション支払いリンク](https://docs.komoju.com/ja/docs/integration-guides/payment-links-subscriptions.md): 「サブスクリプション支払いリンク」の作成・管理方法を説明します。週払い・月払い・年払いの定期課金をリンク型決済で設定できます。
- [React Native](https://docs.komoju.com/ja/docs/integration-guides/react-native-integration.md): KOMOJU React Native SDK は、モバイルアプリケーション内で安全に決済を処理します。
- [ダイレクト・インテグレーション](https://docs.komoju.com/ja/docs/integration-guides/introduction-to-payments-api.md): KOMOJUのPayments APIを使用してダイレクト統合を行う方法の概要です。
- [決済の作成](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): KOMOJUのPayments APIが必要とする決済方法ごとの詳細情報のリファレンスです。
- [詐欺の詳細](https://docs.komoju.com/ja/docs/integration-guides/payments-api-fraud-details.md): KOMOJUのfraud_detailsオブジェクトのリファレンスです。チャージバックを減らし取引の正当性を向上させるために顧客情報を渡します。
- [セッションなしで３Dセキュアー](https://docs.komoju.com/ja/docs/integration-guides/payments-api-3ds.md): ペイメントを直接作成する際の3DSガイド
- [端末での決済の開始](https://docs.komoju.com/ja/docs/integration-guides/komoju-terminal-overview.md): このガイドでは、API を使用せず、端末で手動で決済を開始する方法について説明します。
- [クラウド端末 API](https://docs.komoju.com/ja/docs/integration-guides/komoju-terminal-cloud-api.md): KOMOJUのCloud Terminal APIを使用して端末デバイスで決済を開始し、Webhookの処理や領収書・セッションの管理を行う方法を説明します。
- [端末を使用した決済管理](https://docs.komoju.com/ja/docs/integration-guides/komoju-terminal-payment-management.md): このガイドでは、端末上で決済を管理する方法について説明します。
- [他のアプリからの取引の開始](https://docs.komoju.com/ja/docs/integration-guides/komoju-terminal-third-party-integrations.md): このガイドでは、他のアプリから他の取引を開始する方法について説明します。
- [Eコマース統合](https://docs.komoju.com/ja/docs/integration-guides/ec-integrations/overview.md): KOMOJUのEコマースプラットフォーム連携の概要。コードを書かずに、ShopifyやWooCommerceなどのプラットフォームでクレジットカード、PayPay、コンビニ決済などの決済手段を追加できます。
- [Wixをはじめる](https://docs.komoju.com/ja/docs/integration-guides/ec-integrations/wix/getting-started-with-wix.md): KOMOJUをWixストアに接続し、決済設定を行い、各種決済方法を有効化してLiveモードでの運用を開始する手順です。
- [WixにおけるKOMOJU注文・決済の仕組み](https://docs.komoju.com/ja/docs/integration-guides/ec-integrations/wix/komoju-orders-on-wix.md): WixとKOMOJUの注文・決済データの紐づけ、支払いIDでの検索方法、注文ステータスのライフサイクルとキャリア決済の留意点について解説します。

## 開発

- [テストカード](https://docs.komoju.com/ja/docs/development/testing-inputs.md): KOMOJUテストモードで使用できるテストカード番号と決済手段別の入力値を紹介します。
- [決済の詳細のトークン化](https://docs.komoju.com/ja/docs/development/tokenizing-payment-details.md): クレジットカード情報をクライアント側でトークン化することで、PCI-DSSの負担なしにKOMOJUの決済APIを利用する方法を説明します。
- [長期トークン](https://docs.komoju.com/ja/docs/development/long-term-tokens.md): KOMOJUのお客様オブジェクトを使って決済の詳細を長期保存する方法を説明します。サブスクリプションやカードオンファイル決済のユースケースに対応します。
- [2段階キャプチャ](https://docs.komoju.com/ja/docs/development/advanced-payments/two-step-payments.md): 承認とキャプチャを分離する方法とタイミング
- [3Dセキュア 2.0](https://docs.komoju.com/ja/docs/development/testing-3ds.md): Secure Token APIは、KOMOJU上のクレジット決済において、3D Secure 2.0をサポートするためのAPIです。
- [Ruby](https://docs.komoju.com/ja/docs/development/sdks/ruby.md): KOMOJU Payments APIに対応した公式Ruby SDK（gem）の導入、セッション作成、Webhook署名検証、エラー処理についてのガイドです。
- [Node](https://docs.komoju.com/ja/docs/development/sdks/node.md): KOMOJU Payments APIに対応した公式TypeScript/JavaScript Node SDKの導入、セッション作成、エラー処理についてのガイドです。
- [PHP](https://docs.komoju.com/ja/docs/development/sdks/php.md): GuzzleをベースにしたKOMOJU Payments API対応の公式PHP SDKの導入、セッション作成、Webhook検証、例外処理についてのガイドです。
- [MultiPay (Legacy)](https://docs.komoju.com/ja/docs/development/multipay-legacy.md): KOMOJU MultiPay ポップアップ型支払いウィジェット（レガシー）の導入ガイドです。新規導入にはホストフィールドをおすすめします。

## Platform Model

- [概要](https://docs.komoju.com/ja/docs/platform-model/platform-model-overview.md): プラットフォーム加盟店とマーケットプレイス加盟店の決済処理要件を満たす
- [用語集](https://docs.komoju.com/ja/docs/platform-model/platform-model-glossary.md): KOMOJU Platform Model で使用される専門用語を収録しています
- [ビジネスユースケース](https://docs.komoju.com/ja/docs/platform-model/platform-model-use-cases.md): 貴社のビジネスにどのユースケースが当てはまるかを特定する必要があります
- [プラットフォーム向け](https://docs.komoju.com/ja/docs/platform-model/introduction-to-platform-businesses.md): ユースケースはプラットフォーム事業に適用される
- [プラットフォーム加盟店のオンボーディング](https://docs.komoju.com/ja/docs/platform-model/platform-business-onboarding.md): 「プラットフォーム加盟店」アカウントを登録する
- [プラットフォーム事業者のオンボーディング](https://docs.komoju.com/ja/docs/platform-model/seller-merchant-onboarding.md): 「プラットフォーム事業者」アカウントを登録する
- [販売者決済処理モデル (プラットフォーム向け)](https://docs.komoju.com/ja/docs/platform-model/seller-merchant-payment-processing.md): プラットフォーム加盟店とプラットフォーム事業者間の決済処理方法
- [マーケットプレイス向け](https://docs.komoju.com/ja/docs/platform-model/introduction-to-marketplace-businesses.md): ユースケースはマーケットプレイス事業に適用される
- [マーケットプレイス加盟店のオンボーディング](https://docs.komoju.com/ja/docs/platform-model/marketplace-business-onboarding.md): 「マーケットプレイス加盟店」アカウントを登録する
- [マーケットプレイス事業者のオンボーディング](https://docs.komoju.com/ja/docs/platform-model/payout-merchant-onboarding.md): 「マーケットプレイス事業者」アカウントを登録する
- [プラットフォーム決済処理モデル (マーケットプレイス向け)](https://docs.komoju.com/ja/docs/platform-model/platform-merchant-payment-processing.md): マーケットプレイス加盟店とマーケットプレイス事業者間の決済処理方法
- [決済処理](https://docs.komoju.com/ja/docs/platform-model/payment-processing-overview.md): 貴社と販売事業者間の決済処理方法の概要
- [残高移行](https://docs.komoju.com/ja/docs/platform-model/balance-transfers.md): 加盟店と販売事業者間の残高を転送する
- [加盟店と販売事業者への払い出し](https://docs.komoju.com/ja/docs/platform-model/payouts-overview.md): 加盟店と販売事業者の残高が銀行口座に払い出される頻度を設定する方法
- [販売事業者の管理](https://docs.komoju.com/ja/docs/platform-model/sub-merchant-management.md): 販売事業者を効率的に管理する方法
- [アカウントの管理](https://docs.komoju.com/ja/docs/platform-model/account-management.md): アカウントを効率的に管理する方法
- [Webhook (プラットフォーム モデル向け)](https://docs.komoju.com/ja/docs/platform-model/webhooks-in-the-platform-model.md): KOMOJU プラットフォーム モデルにおける Webhook の機能

## その他

- [GrabPay新規受付の終了](https://docs.komoju.com/ja/docs/changelog/2026-01-06-grabpay-onboarding-deprecation.md): 提携先PPROによるサービス提供終了に伴い、新規申込フォームからGrabPayの受付を終了しました。
- [v.2025-01-28](https://docs.komoju.com/ja/docs/changelog/2025-01-28-unstable-more-details-in-responses-of-settlements-api-endpoints.md): APIバージョン v.2025-01-28 では、部分入金の表現方法を改善し、決済に関する情報を拡張しました（CSVおよびXLS形式を刷新しました）。また、プラットフォームモデルのアップデートを導入しました。
- [APIバージョン管理の導入](https://docs.komoju.com/ja/docs/changelog/2025-01-14-introducing-api-versioning.md): 柔軟性と信頼性を向上させるため、APIバージョン管理を導入します。詳しくはこの変更履歴の投稿をご覧ください。
- [v.2026-01-27](https://docs.komoju.com/ja/docs/changelog/2026-01-27-v2026-01-27.md): APIバージョン v.2026-01-27 ではapi/v1/paymentsエンドポイントにおける税金の計算方法を調整しました。
- [対面決済向け中小企業優遇手数料プランの提供](https://docs.komoju.com/ja/docs/changelog/2026-03-09-subsidized-smb-pricing-for-face-to-face-payments.md): KOMOJU端末をご利用の中小実店舗加盟店様向けに、クレジットカード手数料を従来の2.88%または3.2%から2.4%に引き下げる優遇レートの適用を開始しました。
- [残高・出金管理画面のリニューアル](https://docs.komoju.com/ja/docs/changelog/2026-02-25-balances-and-payouts-merchant-ui.md): 出金と精算のビューを統合し、過去および今後の出金予定の詳細を確認できる新しい残高・出金ページをリリースしました。
- [Apple PayをAPI接続の加盟店向けに提供拡大](https://docs.komoju.com/ja/docs/changelog/2026-01-14-apple-pay-expanded-to-api-merchants.md): ホストページ、WooCommerce、Hosted Fieldsでの提供に加え、直接API連携をご利用の加盟店様でもApple Payが利用可能になりました。
- [メルペイの申込対象を個人事業主へ拡大](https://docs.komoju.com/ja/docs/changelog/2026-04-15-merpay-eligibility-extended-to-sole-proprietors.md): 法人加盟店様に加えて、個人事業主の加盟店様でもメルペイ決済をご利用いただけるようになりました。
- [高リスク判定カード決済における3Dセキュア認証へのフォールバック](https://docs.komoju.com/ja/docs/changelog/2026-04-16-3d-secure-challenge-fallbacks-for-high-risk-card-payments.md): 高リスクと判定されたカード決済を自動拒否するのではなく、3Dセキュア追加認証（チャレンジ認証）を要求し、認証に成功した場合に決済を継続する仕組みを導入しました。
- [決済リンクの複製機能](https://docs.komoju.com/ja/docs/changelog/2026-04-28-duplicate-payment-links.md): 既存の決済リンクをワンクリックで複製できるようになりました。タイトル以外の全設定が引き継がれ、タイトルには一意性を保つため「(1)」が自動付与されます。
- [ShopifyにおけるPayPay決済時の中間確認ページの撤廃](https://docs.komoju.com/ja/docs/changelog/2026-05-21-paypay-intermediate-page-deprecation-shopify.md): Shopifyチェックアウト時にPayPayへリダイレクトする前に表示されていた中間確認画面を撤廃しました（売り越し防止機能未使用時）。
- [決済リンクの主要UI/UXの改善](https://docs.komoju.com/ja/docs/changelog/2026-06-05-payment-links-core-ux-improvements.md): 作成直後のURL/QRコード自動ポップアップ表示、UIパターンの標準化、クイックリンクと通常決済リンクのナビゲーション整理など、決済リンクの操作性を改善しました。
- [チャージバック（不審請求）カスタムレポート機能](https://docs.komoju.com/ja/docs/changelog/2026-06-08-chargeback-custom-reporting.md): 進行中の不審請求申請、異議申し立ての勝率、未回収データの追跡が可能なカスタムレポート機能を加盟店ダッシュボードに追加しました。
- [決済リンクの自動有効期限・支払い上限設定](https://docs.komoju.com/ja/docs/changelog/2026-06-09-auto-expiring-payment-links.md): 決済回数の上限または指定日時に達した際に、決済リンクを自動的に無効化する設定が可能になりました。
- [WooCommerce公式パートナーシップ締結と公式プラグイン公開](https://docs.komoju.com/ja/docs/changelog/2026-07-28-official-woocommerce-partnership-and-core-plugin-launch.md): KOMOJUがWooCommerceの公式パートナーとなり、WooCommerce.comから直接KOMOJUプラグインをインストールできるようになりました。
- [決済リンクごとの利用可能決済手段の選択機能](https://docs.komoju.com/ja/docs/changelog/2026-07-22-selectable-payment-methods-on-payment-links.md): 全決済手段を提供する代わりに、特定の決済手段（例：クレジットカードのみなど）に限定した決済リンクを作成できるようになりました。
- [3Dセキュア認証のNetceteraへの移行](https://docs.komoju.com/ja/docs/changelog/2026-08-01-3ds-authentication-netcetera-migration.md): LiveモードとTestモードの3Dセキュア認証をNetceteraへ移行しました。加盟店側での対応は不要です。
- [Google Payの3Dセキュア認証とカードブランドの絞り込み](https://docs.komoju.com/ja/docs/changelog/2026-08-31-google-pay-card-filtering.md): Google Payで加盟店アカウントに有効なカードブランドのみが表示されるようになり、3Dセキュアのチャレンジ認証にも完全に対応しました。
- [チャージバック管理ツールとAPIの提供開始](https://docs.komoju.com/ja/docs/changelog/2026-08-19-chargeback-management-tool-and-api.md): 加盟店ダッシュボードまたはAPIから、チャージバックの確認、受け入れ、反証資料の提出を行えるようになりました。
- [決済リンクでのワンクリック配送先住所収集機能](https://docs.komoju.com/ja/docs/changelog/2026-02-04-one-click-address-collection-on-payment-links.md): 手動でカスタムテキスト項目を設定することなく、ワンクリックで決済リンク上に顧客の配送先住所収集項目を追加できるようになりました。
- [残高不足による返金失敗に専用エラーコードを追加](https://docs.komoju.com/ja/docs/changelog/2026-09-04-insufficient-balance-refund-error.md): アカウントの残高が返金額に満たない場合、返金エンドポイントがエラーコード insufficient_balance を返すようになりました。
- [新しい「決済レポート」ページを公開](https://docs.komoju.com/ja/docs/changelog/2026-09-02-financial-summary-page.md): 従来の「レポート」画面に代わる「決済レポート」ページを公開し、概要カード、事前計算済みの合計額、精算CSVエクスポートと統一された用語で財務状況を確認できるようになりました。
- [WooCommerceプラグイン v3.3.3: 決済手段の説明文表示とコールバックの修正](https://docs.komoju.com/ja/docs/changelog/2026-09-09-woocommerce-plugin-update-3-3-3.md): KOMOJU WooCommerceプラグインのバージョン3.3.3で、クラシックチェックアウトに決済手段のカスタム説明文が表示されるようになり、Webhookコールバックの遅延も修正されました。
- [実店舗端末向けWeChat Payの申込に対応](https://docs.komoju.com/ja/docs/changelog/2026-09-10-wechat-pay-instore-applications.md): KOMOJU Terminalを利用する加盟店は、ダッシュボードから店頭でのWeChat Pay導入を申し込めるようになりました。
- [カード確認に0円オーソリを導入](https://docs.komoju.com/ja/docs/changelog/2026-09-14-zero-amount-card-verification.md): VisaおよびMastercardのガイドラインに従い、保存済みカードの確認を1円ではなく0円のオーソリで行うようになりました。
- [「精算詳細」ページと「請求書」ページのリニューアル](https://docs.komoju.com/ja/docs/changelog/2026-09-15-redesigned-settlement-details-and-invoices-pages.md): 加盟店ダッシュボードの「精算詳細」ページと「請求書」ページが新しいレイアウトになり、入金額の詳細な内訳の確認、請求書のプレビュー、一括ダウンロードに対応しました。
- [Subscriptions API: 固定の課金日と日割り計算に対応](https://docs.komoju.com/ja/docs/changelog/2026-09-24-subscriptions-fixed-billing-dates-and-proration.md): すべての顧客に決まった日に課金できるようになり、サイクルの途中で加入した顧客には初回に日割り金額を請求することもできます。

## API リファレンス

- [KOMOJU API Reference (2025-01-28)](https://docs.komoju.com/en/api-reference/2025-01-28/index.md): Full featured access to the KOMOJU payments system.
  - [Payments](https://docs.komoju.com/en/api-reference/2025-01-28/resources/payments.md): A **Payment** represents a single charge against a customer for a specific amount in a specific currency.
  - [Sessions](https://docs.komoju.com/en/api-reference/2025-01-28/resources/sessions.md): A **Session** is a hosted checkout experience that walks a customer through selecting a payment method and completing a payment.
  - [Tokens](https://docs.komoju.com/en/api-reference/2025-01-28/resources/tokens.md): A **Token** is a reusable, PCI-safe reference to a customer's credit card.
  - [Secure Tokens](https://docs.komoju.com/en/api-reference/2025-01-28/resources/secure-tokens.md): A **Secure Token** is a 3-D Secure–authenticated token that carries the result of a strong customer authentication challenge.
  - [Subscriptions](https://docs.komoju.com/en/api-reference/2025-01-28/resources/subscriptions.md): A **Subscription** charges a customer on a recurring schedule using a stored credit card token.
  - [Chargebacks](https://docs.komoju.com/en/api-reference/2025-01-28/resources/chargebacks.md): A **Chargeback** is a customer-initiated dispute against a card payment.
  - [Events](https://docs.komoju.com/en/api-reference/2025-01-28/resources/events.md): An **Event** is an immutable record of something that happened in your KOMOJU account — a payment being captured, a chargeback being filed, a subscription renewing, and so on.
  - [Settlements](https://docs.komoju.com/en/api-reference/2025-01-28/resources/settlements.md): A **Settlement** is a periodic accounting record that summarizes payments, refunds, and fees for a given settlement period.
  - [Platform](https://docs.komoju.com/en/api-reference/2025-01-28/resources/platform-model.md): The **Platform** endpoints power marketplaces and platforms built on top of KOMOJU.
  - [One Click](https://docs.komoju.com/en/api-reference/2025-01-28/resources/one-click.md): The **One Click** endpoints let a returning customer complete a purchase without re-entering payment details.
  - [Barcodes](https://docs.komoju.com/en/api-reference/2025-01-28/resources/barcodes.md): The **Barcodes** endpoint returns the barcode or QR code image for a payment method that requires the customer to pay at a physical location (for example, a konbini or a bank ATM).
- [KOMOJU API Reference (2024-07-15)](https://docs.komoju.com/en/api-reference/2024-07-15/index.md): Full featured access to the KOMOJU payments system.
  - [Payments](https://docs.komoju.com/en/api-reference/2024-07-15/resources/payments.md): A **Payment** represents a single charge against a customer for a specific amount in a specific currency.
  - [Sessions](https://docs.komoju.com/en/api-reference/2024-07-15/resources/sessions.md): A **Session** is a hosted checkout experience that walks a customer through selecting a payment method and completing a payment.
  - [Tokens](https://docs.komoju.com/en/api-reference/2024-07-15/resources/tokens.md): A **Token** is a reusable, PCI-safe reference to a customer's credit card.
  - [Secure Tokens](https://docs.komoju.com/en/api-reference/2024-07-15/resources/secure-tokens.md): A **Secure Token** is a 3-D Secure–authenticated token that carries the result of a strong customer authentication challenge.
  - [Subscriptions](https://docs.komoju.com/en/api-reference/2024-07-15/resources/subscriptions.md): A **Subscription** charges a customer on a recurring schedule using a stored credit card token.
  - [Events](https://docs.komoju.com/en/api-reference/2024-07-15/resources/events.md): An **Event** is an immutable record of something that happened in your KOMOJU account — a payment being captured, a chargeback being filed, a subscription renewing, and so on.
  - [Settlements](https://docs.komoju.com/en/api-reference/2024-07-15/resources/settlements.md): A **Settlement** is a periodic accounting record that summarizes payments, refunds, and fees for a given settlement period.
  - [Platform](https://docs.komoju.com/en/api-reference/2024-07-15/resources/platform-model.md): The **Platform** endpoints power marketplaces and platforms built on top of KOMOJU.
  - [One Click](https://docs.komoju.com/en/api-reference/2024-07-15/resources/one-click.md): The **One Click** endpoints let a returning customer complete a purchase without re-entering payment details.
  - [Barcodes](https://docs.komoju.com/en/api-reference/2024-07-15/resources/barcodes.md): The **Barcodes** endpoint returns the barcode or QR code image for a payment method that requires the customer to pay at a physical location (for example, a konbini or a bank ATM).