# 概要

> 2328.io と統合して暗号資産の決済処理および出金を行うための技術仕様。

2328.io API ドキュメントへようこそ。本リファレンスでは、暗号資産の決済処理および出金をアプリケーションに統合する方法を説明します。

## はじめに

統合を始めるには：

1. [2328.io](https://2328.io) でマーチャントアカウントとプロジェクトを作成します
2. プロジェクト設定から **project UUID** と **API key** を取得します
3. 出金機能を利用する場合は、別途 **Payout API key** を生成します
4. [Authentication](/docs/authentication) セクションを参照し、リクエストへの署名方法を確認します
5. 最初の [Create Payment](/docs/payments) 呼び出しを行います

## ベース URL

すべての本番 API リクエストは以下のベース URL を使用します：

```
https://api.2328.io/api
```

> **WARNING:** すべてのリクエストは **HTTPS** で行う必要があります。HTTPS を使用しないリクエストはブロックされます。

## できること

2328.io API を利用することで、以下が可能です：

- **暗号資産による決済の受付** — 決済セッションを作成し、ホスト型のチェックアウトページまたは Telegram MiniApp に顧客をリダイレクトします
- **資金の出金** — マーチャント残高から任意のブロックチェーンアドレスへプログラム的に出金します
- **残高確認** — 通貨ごとのマーチャント残高、USD 換算、AML でロックされた金額を確認できます
- **固定ウォレットの利用** — ユーザーや注文に紐付く永続的な入金アドレスを生成します
- **為替レートの取得** — 法定通貨と暗号資産のリアルタイムレートを取得します
- **Webhook の受信** — 支払いステータスが変化した際に即座に通知を受け取ります
## レート制限

API はプロジェクトごとに **1 秒あたり最大 10 リクエスト** を許可しています。制限を超えたリクエストは HTTP `429 Too Many Requests` レスポンスを受け取ります — バックオフして再試行してください。