> ## 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.

# Hello Clever API の概要

> Hello Clever の API 群は5つのバージョン管理された API で構成されます。AUD の決済、多通貨の Payin/Payout、ゲートウェイのチェックアウト、カード処理、キャッシュバックの特典です。

Hello Clever の API 群は、同社のフィンテックプラットフォーム上に決済体験を構築するために必要なすべてを提供します。このページでは各 API のバージョンを紹介し、それぞれの用途を説明し、連携に適したものを選べるようにします。

<a id="base-urls" />

## ベース URL

各 API のバージョンには独自のベース URL があります。開発中はサンドボックスのエンドポイントを使い、本番稼働時に本番環境へ切り替えてください。

| API          | 本番環境のベース URL                              | サンドボックスのベース URL                           |
| ------------ | ----------------------------------------- | ----------------------------------------- |
| **v1**       | `https://api-merchant.helloclever.co/api` | `https://api.cleverhub.co/api`            |
| **v2**       | `https://api-merchant.helloclever.co/api` | `https://api.cleverhub.co/api`            |
| **v3**       | `https://api-merchant.helloclever.co/api` | `https://api.cleverhub.co/api`            |
| **Card**     | `https://api.lightningpay.me/api`         | `https://sandbox-api.lightningpay.me/api` |
| **Cashback** | `https://api-merchant.helloclever.co/api` | `https://api.cleverhub.co/api`            |

<Note>
  すべての API リクエストで必ず HTTPS を使用してください。暗号化されていない接続で認証情報を送らないでください。
</Note>

## API のバージョンの一覧

<CardGroup cols={2}>
  <Card title="API v1：AUD Payment Gateway" icon="dollar-sign" href="/ja/api/v1/introduction">
    オーストラリアドルの取引向けの、Hello Clever の初期の決済ゲートウェイです。PayID、PayTo、BSB/口座番号による送金、AUD の Payout に対応します。キャッシュバックキャンペーンの連携も含みます。AUD のみで事業を行い、PayID や PayTo への対応が必要な場合はこの API を使ってください。
  </Card>

  <Card title="API v2：Multi-Currency Payments" icon="globe" href="/ja/api/v2/introduction">
    複数の通貨に対応した、機能の揃った Payin と Payout の API です。モバイルマネー、バーチャル口座への銀行振込、顧客とコンタクトの管理、VND の銀行照会を含みます。AUD 以外の通貨で決済を受け付けたり送金したりする必要がある場合はこの API を使ってください。
  </Card>

  <Card title="API v3：Payment Gateway 3" icon="credit-card" href="/ja/api/v3/introduction">
    1つの連携点ですべての通貨を扱うホスト型のゲートウェイのチェックアウト API です。手順に沿った連携の流れと、ステータス変更に対する Webhook のサポートが組み込まれています。決済フォームの UI を自ら構築せずに、管理されたチェックアウト体験を利用したい場合はこの API を使ってください。
  </Card>

  <Card title="Card API" icon="credit-card" href="/ja/api/card/overview">
    JavaScript SDK（クライアントサイド、AUD と USD）またはサーバー間通信 (S2S) の連携（サーバーサイド、AUD のみ）でカード決済を受け付けます。継続決済のためのカードのトークン化、3DS 認証、通常および非定期の決済種別、返金に対応します。
  </Card>

  <Card title="Cashback API" icon="tag" href="/ja/api/cashback/overview">
    顧客向けのキャッシュバックキャンペーンと特典を管理します。キャンペーンの一覧を取得し、キャッシュバックの操作を実行できます。決済の連携の上にロイヤルティと特典のプログラムを構築する場合はこの API を使ってください。
  </Card>
</CardGroup>

## 各バージョンの使いどころ

| 要件                                | 推奨する API         |
| --------------------------------- | ---------------- |
| PayID を使う AUD のみの決済               | v1               |
| PayTo 契約を使う AUD のみの決済             | v1               |
| AUD のみの BSB/口座番号による送金             | v1               |
| 多通貨の Payin と Payout               | v2               |
| モバイルマネーまたはバーチャル口座への送金             | v2               |
| ホスト型の多通貨チェックアウトページ                | v3               |
| JavaScript SDK によるカード決済 (AUD、USD) | Card API（SDK 連携） |
| SDK を使わないサーバーサイドのカード決済（AUD のみ）    | Card API（S2S 連携） |
| 保存したトークンによる継続的なカード決済              | Card API         |
| キャッシュバックキャンペーンと特典                 | Cashback API     |

## 認証

Hello Clever API へのすべてのリクエストでは、`app-id` と `secret-key` による認証が必要です。認証情報の取得方法とリクエストでの渡し方の手順は、[認証](/ja/api/authentication)のページを参照してください。

## Webhook

Hello Clever は、決済のステータスが変わったときに Webhook でサーバーへ通知します。ペイロードの完全なリファレンス、ステータスの一覧、セキュリティの設定、リトライの挙動については、[Webhook](/ja/api/webhooks) のページを参照してください。


## Related topics

- [Cashback API の概要](/ja/api/cashback/overview.md)
- [Clever Connect の概要](/ja/platform-overview/clever-concepts/overview.md)
- [カード決済 API の概要](/ja/api/card/overview.md)