---
title: "Payments"
description: "KOMOJUの決済リソース、6つの決済ステータス（`authorized`の2つの意味を含む）、および決済手段ごとに固有のデータを表す payment_details について解説します。"
url: "https://docs.komoju.com/ja/docs/introduction/payments"
source_url: "https://docs.komoju.com/ja/docs/introduction/payments.md"
language: ja
last_modified: "2026-03-26"
---

KOMOJU をどのように導入するかにかかわらず、直接的あるいは間接的に「決済（payment）」を扱うことになります。Shopify や WooCommerce などの EC プラグイン経由の連携でも、内部では決済が作成されており、それらは API から参照・操作できます。

決済は、お客様から受け取った金銭を表すリソースです。すべての決済は少なくとも `amount`（金額）と `currency`（通貨）を持ちます。全属性の詳細は [Payment: Show API リファレンス](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/payments/GET/payments/%7Bid%7D)で確認できます。

# 決済ステータス

決済には読み取り専用の `status` フィールドがあり、資金が回収されたかどうかを示します。

| ステータス | 意味 |
| --- | --- |
| `pending` | 決済は開始されましたが、まだ確定していません。顧客の操作を待っている状態です。 |
| `authorized` | 下記の [`authorized` の2つの意味](https://docs.komoju.com/#the-two-meanings-of-authorized) を参照してください。 |
| `captured` | 決済が成功しました。次回の入金サイクルで指定の銀行口座に振り込まれます。 |
| `refunded` | 決済は完了しましたが、全額返金されました。なお、部分返金の場合は `captured` のままです。 |
| `cancelled` | 加盟店または顧客のいずれかによってキャンセルされた決済です。 |
| `expired` | `pending` または `authorized` のまま一定期間操作がなかったため、有効期限が切れた決済です。 |

## `authorized` の2つの意味

`authorized` ステータスは、決済手段によって意味が異なります。

1. **時間のかかる非同期の決済手段**（`konbini`、`bank_transfer`、`payeasy`）— 決済は予約されており、顧客の操作を待っている状態です（例：コンビニで現金を支払うのを待っている）。
2. **その他すべての決済手段** — `authorized` はクレジットカードの与信を指します。資金は加盟店側で確保されていますが、まだ顧客の口座からは引き落とされていません。この状態の決済は、加盟店側の操作（商品発送時の手動キャプチャなど）を待っています。詳細は[2段階キャプチャ](https://docs.komoju.com/ja/docs/development/advanced-payments/two-step-payments.md)を参照してください。

# Payment details（高度な連携でのみ使用）

KOMOJU では、決済手段ごとに固有の情報を「payment details」（API では `payment_details`）と呼びます。たとえば、クレジットカード決済ではカード番号や有効期限、コンビニ決済では顧客が支払うコンビニチェーンなどが該当します。これらの情報がすべて payment details です。

API では、`payment_details` は以下の場面で使用されます。

- [決済の作成](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/payments/POST/payments)
- [Session の支払](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/sessions/POST/sessions/%7Bid%7D/pay)
- [Token の作成](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/tokens/POST/tokens)
- [Customer の作成](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/customers/POST/customers)

[Hosted Page](https://docs.komoju.com/ja/docs/integration-guides/web-integrations/introduction-to-hosted-page.md) または [Hosted Fields](https://docs.komoju.com/ja/docs/integration-guides/introduction-to-hosted-fields.md) を利用している場合、_payment details を直接扱う必要はありません_。決済手段ごとのフィールド一覧については、[Payments API | Payment Details](https://docs.komoju.com/ja/docs/integration-guides/payments-api-payment-details.md) を参照してください。