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

# Multi-Currency Payment API (v2)

> Hello Clever の v2 多通貨 API で、APAC とその他の地域にまたがる Payin と Payout のフローを構築します。1つのスキーマで多数の通貨に対応し、完全にコントロールできます。

Multi-Currency Payment API (v2) は、APAC とその他の地域における複数通貨の決済の受け付けと送金を、統一された1つの API スキーマで実現します。ベトナム、マレーシア、日本、オーストラリアの顧客から決済を回収する場合でも、銀行口座、モバイルマネーのウォレット、QR ベースのネットワークへ支払う場合でも、v2 は一貫した1つのインターフェースでライフサイクル全体を扱います。

## v2 が扱う範囲

<Columns cols={2}>
  <Card title="Payin" icon="arrow-down-to-line">
    銀行振込、電子ウォレット、QR コード、モバイルマネーなどで決済を受け付けます。返金、取消、OTP を用いたモバイルマネーのフローに対応します。
  </Card>

  <Card title="Payout" icon="arrow-up-from-line">
    対応通貨の受取人へ資金を送ります。スケジュール Payout、支店コードの照会、QR による銀行口座の解決を含みます。
  </Card>

  <Card title="顧客とコンタクト" icon="users">
    顧客の記録とコンタクトを作成・管理します。取引の前に本人確認が必要な手段については、KYC の書類を提出できます。
  </Card>

  <Card title="残高" icon="wallet">
    すべての通貨について、利用可能、入金予定、出金予定、ローリングリザーブ、出金可能の各残高を照会し、残高取引の履歴全体を取得できます。
  </Card>
</Columns>

## 対応通貨

v2 API は、Hello Clever の Merchant Dashboard で設定されたすべての通貨に対応します。

| 地域     | 通貨                                      |
| ------ | --------------------------------------- |
| アジア太平洋 | AUD、IDR、INR、JPY、KHR、KRW、MYR、PHP、THB、VND |
| アフリカ   | BWP、GHS、KES、MWK、NGN、TZS、XAF、XOF、ZAR     |
| 南北アメリカ | ARS、BRL、CAD、USD                         |
| その他    | USDC                                    |

自社のアカウントで有効になっている手段を確認するには、[Get Payin Methods](/api/payin-methods/get-payin-methods) または [Get Payout Methods](/api/payout-methods/get-payout-methods) を呼び出してください。追加の通貨を有効にするには [support@helloclever.co](mailto:support@helloclever.co) へお問い合わせください。

<Note>
  GST を `true` に設定すべきなのは、**AUD** の取引を処理するオーストラリアの加盟店のみです。それ以外の通貨では `false` に設定してください。
</Note>

<a id="amount-rounding" />

### 金額の丸め

**VND**、**JPY**、**XAF**、**KRW**、**XOF** では、処理中に各通貨が対応する精度へ取引金額が丸められます。そのため、取引に記録される金額が送信した値とわずかに異なる場合があります。

消込は、送信した値ではなく API のレスポンスと Webhook のペイロードで返される金額に対して行ってください。それ以外の通貨では、金額は送信されたとおりに処理されます。

## ベース URL

| 環境      | ベース URL                                   |
| ------- | ----------------------------------------- |
| サンドボックス | `https://api.cleverhub.co/api`            |
| 本番環境    | `https://api-merchant.helloclever.co/api` |

## 認証

v2 API へのすべてのリクエストには、Hello Clever の Merchant Dashboard から発行される2つのヘッダーベースの APIキーが必要です。

<ParamField header="app-id" type="string" required>
  Hello Clever 内で登録・管理されるアプリケーションの識別子です。すべてのリクエストで必要です。
</ParamField>

<ParamField header="secret-key" type="string" required>
  サーバーサイドのリクエストを認証するために使うクライアントのシークレットです。クライアントサイドのコードで決して露出させないでください。
</ParamField>

```bash Example request theme={null}
curl --request GET \
  --url https://api.cleverhub.co/api/v2/payins/payin_methods \
  --header 'app-id: YOUR_APP_ID' \
  --header 'secret-key: YOUR_SECRET_KEY'
```

## 連携の全体像

一般的な Payin の連携は4つの手順で進みます。

<Steps>
  <Step title="Payin の手段を取得する">
    `GET /v2/payins/payin_methods` を呼び出して、設定した通貨で利用できる決済手段の一覧を取得します。
  </Step>

  <Step title="必須項目を取得する">
    選択した手段のコードを指定して `GET /v2/payins/payin_method/params` を呼び出し、顧客から収集する必要のある項目を確認します。
  </Step>

  <Step title="Payin を作成する">
    手段のコード、必須項目、顧客の情報を指定して `POST /v2/payins` を呼び出し、決済を開始します。
  </Step>

  <Step title="シミュレーションする（サンドボックスのみ）">
    サンドボックス環境では、テストのために `POST /v2/payins/simulate` を呼び出して保留中の決済を完了させます。
  </Step>
</Steps>

Payout のフローも同じパターンに従います。手段の取得、必須項目の取得、Payout の作成です。手段と必須項目の確認は手段ごとに一度だけ必要で、その後は同じ設定を将来の取引に再利用できます。

## リソース

| リソース                                      | 説明                                   |
| ----------------------------------------- | ------------------------------------ |
| [Payin](/api/payin/create-a-payin)        | Payin の取引の作成、取消、返金、照会                |
| [Payout](/api/payout/create-a-payout)     | 資金の送金、スケジュール Payout の管理、QR と支店コードの照会 |
| [顧客とコンタクト](/api/customer/create-customer) | 顧客の記録、コンタクト、KYC の確認の管理               |
| [残高](/api/balance/get-balance-details-v2) | 多通貨の残高の詳細と残高取引の履歴の照会                 |

## 問い合わせと規約

* サポート：[support@helloclever.co](mailto:support@helloclever.co)
* 利用規約：[helloclever.co/terms](https://helloclever.co/terms)


## Related topics

- [Get Balance Details V2](/api/balance/get-balance-details-v2.md)
- [Get Balance History V2](/api/balance/get-balance-history-v2.md)
- [残高 API リファレンス (v2)](/ja/api/v2/balance.md)