Sign in
はじめに/一般情報

概要

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

Markdown で表示·llms.txt

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

はじめに

統合を始めるには：

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

ベース URL

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

Text
https://api.2328.io/api

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

できること

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

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

レート制限

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