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

SDKとライブラリ

公式SDKを使用して統合を加速させましょう。対応する言語はTypeScript、Python、Go、PHP、Java、Kotlin、C#、Ruby、React Nativeです。これらのライブラリはAPIリクエスト、認証、エラーハンドリングを簡素化し、素晴らしい支払い体験の構築に集中できるようにします。

​
環境URL

テストモードとライブモードについて詳しく学びましょう。

​
APIキー管理と認証

1

APIキーにアクセスする

ダッシュボードの開発者 → APIキーに移動して、キーを管理します。
2

新しいキーを生成する

APIキーを追加を選択し、説明的な名前を提供し、書き込みアクセスを設定します:
  • 書き込みアクセスを有効にする（チェック済み）: すべてのAPI操作に対するフルリードおよび書き込み権限
  • 書き込みアクセスを有効にする（未チェック）: 読み取り専用アクセス - データ（支払い、サブスクリプション、顧客、製品）を取得することのみ可能。リソースを作成または変更することはできません。
ダッシュボード統合、分析ツール、および変更を加えずにデータを表示するだけのシステムには、「書き込みアクセスを有効にする」のチェックを外してください。
3

キーを安全に保管する

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

APIリクエストを認証する

APIキーを使用してすべてのリクエストを認証します。以下の認証フォーマットを適用してください:
Authorization: Bearer YOUR_API_KEY
クライアントサイドのコードや公開リポジトリに秘密のAPIキーを決して公開しないでください。

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

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

​
レート制限

  • 標準: 1ビジネスあたり1分間に1000リクエスト
  • バースト: 1秒間に最大100リクエスト
使用状況を追跡するために、X-RateLimit-Remainingヘッダーを監視してください。

​
エラーハンドリング

エラーを効果的に管理するために、_エラーコード_および_トランザクション失敗_セクションを参照して詳細なガイダンスを得てください。

エラーコード

包括的なエラーの詳細とその解決策を掘り下げます。

トランザクション失敗

一般的なトランザクションの問題とその解決策についての洞察を得ます。

​
Webhook

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

Webhookガイド

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