メインコンテンツへスキップ

SDKs & Libraries

TypeScript、Python、Go、PHP、Java、Kotlin、C#、Ruby、React Native に対する公式 SDK を利用して統合を加速しましょう。これらのライブラリは API リクエスト、認証、エラー処理を簡素化し、優れた決済体験の構築に集中できるようにします。

​
環境URL

「テストモード vs 本番モード」について詳しく学んでください。

​
APIキー管理と認証

1

Access API Keys

ダッシュボードで Developer → API Keys に移動し、キーを管理します。
2

Generate a New Key

Add API Key を選択し、わかりやすい名前を入力して書き込みアクセスを設定します:
  • 書き込みアクセスを有効にする（チェック済み）: すべてのAPI操作に対するフルリードおよび書き込み権限
  • 書き込みアクセスを有効にする（未チェック）: 読み取り専用アクセス - データ（支払い、サブスクリプション、顧客、製品）を取得することのみ可能。リソースを作成または変更することはできません。
「Enable write access」のチェックを外して、ダッシュボード統合、分析ツール、およびデータの閲覧のみを行うシステムで書き込み操作を防ぎます。
3

Store Your Key Securely

生成されたキーはすぐにコピーして安全に保管してください。
4

Authenticate Your API Requests

すべてのリクエストで API キーを使って認証を行います。以下の認証形式を適用してください:
Authorization: Bearer YOUR_API_KEY
シークレット API キーをクライアントサイドのコードや公開リポジトリで絶対に公開しないでください。

​
レスポンスフォーマット

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
レート制限

当社の API はバースト保護付きの二重ウィンドウ方式のレート制限を採用しています。制限値は認証方法とビジネスティアに基づいて適用されます。

​
デフォルトの制限（ティア 0）

ウィンドウ制限
1 秒あたり（バースト）40 件
1 分あたり（継続）240 件

​
ビジネスティア

API の利用量が多い企業向けに、より高いレート制限を用意しています:
ティアバースト（1 秒あたり）継続（1 分あたり）
ティア 0（デフォルト）40240
ティア 11001,000
ティア 25005,000
ビジネスをより高いレート制限のティアにアップグレードするにはサポートに連絡してください。

​
未認証リクエスト

有効な認証ヘッダーがないリクエストは IP アドレス単位でレート制限されます:
ウィンドウ制限
1 秒あたり（バースト）20 件
1 分あたり（継続）100 件

​
レート制限ヘッダー

これらのレスポンスヘッダーで使用状況を監視してください:
  • X-RateLimit-Limit - 許可されている最大リクエスト数
  • X-RateLimit-Remaining - 現在のウィンドウで残っているリクエスト数
  • X-RateLimit-Reset - レート制限がリセットされるタイミング
レート制限を超えると API は 429 Too Many Requests レスポンスを返します。リトライロジックには指数バックオフを実装してください。

​
エラー処理

エラーを効果的に管理するには、Error Codes セクションと Transaction Failures セクションで詳細なガイダンスをご確認ください。

Error Codes

包括的なエラーの詳細とその解決方法を掘り下げてください。

Transaction Failures

一般的なトランザクションの問題とその解決策に関する洞察を得ることができます。

​
Webhooks

支払いイベントに関するリアルタイム通知を受け取ります。設定手順については Webhook Guide を参照してください。

Webhook Guide

リアルタイム通知とイベント処理のために Webhook を設定しましょう。