> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rc.cleverhub.co/llms.txt
> Use this file to discover all available pages before exploring further.

# カード決済 API の概要

> Hello Clever の Card API は、SDK またはサーバー間通信のモードで、AUD と USD のカード決済のオーソリ、キャプチャ、返金、Void、トークン化に対応します。

Hello Clever の Card API では、クレジットカードとデビットカードの決済を受け付けられます。3DS2 認証、遅延キャプチャ、返金、Void、そしてリピート顧客のためのカードのトークン化に完全に対応しています。クライアントサイドで組み込める UI を提供する JavaScript SDK か、バックエンドを完全にコントロールできるサーバー間通信 (S2S) のリクエストのいずれかで連携できます。

## 連携のモード

<CardGroup cols={2}>
  <Card title="SDK 連携" icon="browser" href="/api/cards/create-payment-via-tokenisation">
    ウェブとモバイル向けのクライアントサイド JavaScript SDK です。USD と AUD に対応します。カード入力の UI は Hello Clever が描画するため、フロントエンドに PCI の対象範囲は生じません。
  </Card>

  <Card title="サーバー間通信 (S2S)" icon="server" href="/api/cards/create-payment-via-card-information-s2s">
    PCI DSS に準拠したサーバーから、生のカード情報を Card API へ直接送信します。AUD のみに対応します。オーソリとキャプチャのフローを完全にコントロールできます。
  </Card>
</CardGroup>

## 認証

Card API は、Bearer トークンではなく `app-id` と `secret-key` をリクエストのヘッダーとして使用します。

```bash theme={null}
curl https://api.lightningpay.me/api/v2/cards/charges \
  -H "app-id: your-app-id" \
  -H "secret-key: your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{...}'
```

`app-id` と `secret-key` は Merchant Portal（マーチャントポータル）から取得します。[連携キー](/ja/integration-keys)を参照してください。

## 決済のライフサイクル

<Steps>
  <Step title="charge を作成する">
    カード情報を送信する (S2S) か、SDK を使って収集します。API はオーソリの結果を返します。
  </Step>

  <Step title="必要な場合は 3DS を処理する">
    カードが 3DS 認証を必要とする場合、レスポンスに `3ds_url` が含まれます。顧客をこの URL へリダイレクトしてください。認証の後、顧客は `return_url` へ戻ります。
  </Step>

  <Step title="決済をキャプチャする">
    `capture: false` を設定した場合は、資金を回収する準備が整った時点でキャプチャのエンドポイントを明示的に呼び出します。`capture: true` の場合は、オーソリ時に自動でキャプチャされます。
  </Step>

  <Step title="返金または Void を行う">
    キャプチャ後は全額または一部の返金を発行でき、まだキャプチャしていない決済は Void で取り消せます。
  </Step>
</Steps>

## カードのトークンの再利用

決済が `authorised` のステータスに達すると、Hello Clever は `token` のオブジェクト（例：`tok_dfe1988a1ffc...`）を返します。このトークンを保存すれば、同じ顧客に対してカード情報を再入力せずに将来の請求ができます。[カードのトークン化](/api/cards/create-payment-via-tokenisation)を参照してください。

## Webhook の通知

カード決済のステータスの変更は、設定した Webhook のエンドポイントへ配信されます。`authorised`、`received`、`failed`、`return_received` などのイベントを購読してください。イベントのリファレンスとペイロードのスキーマの全体は [Webhook](/ja/api/webhooks) を参照してください。


## Related topics

- [カード決済の仕組み](/ja/platform-overview/payment-concepts/how-cards-work.md)
- [リアルタイム決済とカード決済の比較](/ja/platform-overview/payment-concepts/rtp-vs-cards.md)
- [カード Payin サービス：カード決済の受け付け](/ja/services/card-payin.md)