API & SDK

ビルダーのために作られたAPI

OpenAPI 3.1、冪等性キー、カーソルページネーション、JavaScript・Python・PHP・Ruby・Go・C#のSDKを備えたREST API。

Baynoy APIで作業する開発者

<150ms

P50 APIレイテンシ

99.95%

稼働率SLA

6

公式SDK

  • OpenAPI 3.1仕様
  • 冪等性キー
  • カーソルページネーション
  • Bearer認証
  • HMAC webhook
  • サンドボックス + テストカード
  • 6つの公式SDK
  • 1,000 req/秒のレート制限
  • 99.95%稼働率SLA

課金を作成

1つのエンドポイント、30の方法

単一のリソースを POST すれば、あとは Baynoy が処理します — カード、Apple Pay、Google Pay。送金先通貨を設定すれば、決済時に銀行またはウォレットへ支払いをルーティングします。

  • Idempotency-Keyがリトライ時の二重課金を防止
  • 大量レポートのためのカーソルページネーション
  • checkout_url経由のインライン3DSチャレンジ
  • サンドボックスキーは実金には決して触れない

リクエスト

POST /v1/payments
Authorization: Bearer sk_live_••••
Idempotency-Key: 7a1f2e

{
  "amount": 125000,
  "currency": "EUR",
  "payout":  { "type": "bank", "currency": "TRY" },
  "methods": ["card","usdc","sepa"],
  "metadata": { "patient_id": "p_8821" }
}

レスポンス

{
  "id": "pmt_a7c91...",
  "status": "requires_action",
  "checkout_url": "https://pay.baynoy.com/c/a7c91"
}

クイックスタート

# No SDK to install — it's a plain REST API.
# Create a payment link from any HTTP client:
curl https://baynoy.com/api/v1/payment-links \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Invoice 0042","amount":2000,"currency":"USD"}'

REST API

どの言語からでも呼び出せます

Bearer 認証のシンプルな REST API — インストールする SDK はありません。curl、fetch、requests など任意の HTTP クライアントから呼び出せます。本番対応: バージョン管理されたレスポンス、冪等なリトライ、署名付き Webhook、カーソルページネーション。

  • Baynoy-Version ヘッダーによる安定したバージョン管理レスポンス
  • すべての POST に Idempotency-Key — リトライで二重課金されません
  • HMAC-SHA256 署名付き Webhook(t=…,v1=…)
  • すべてのリストエンドポイントでカーソルページネーション
ドキュメントを読む

Webhooks

信頼できるイベント

すべてのwebhookはHMAC SHA-256で署名され、指数バックオフで最大7日間リトライされ、ダッシュボードでrequest / response履歴とともに閲覧可能。過去のイベントをワンクリックでリプレイ。

  • HMAC SHA-256署名されたペイロード
  • 決済ライフサイクル全体をカバーする8つのイベントタイプ
  • 最大7日間の指数バックオフ
  • ダッシュボードからワンクリックリプレイ
エンドポイントを管理

署名されたイベント

POST /your-endpoint
Baynoy-Signature: t=1716210000,v1=8b3...
Content-Type: application/json

{
  "id": "evt_2zX...",
  "type": "payment.succeeded",
  "data": { "object": { "id": "pmt_a7c91..." } }
}

キーを取得し、課金を送信

サンドボックスキーはすぐに発行されます。Tier 1認証後、本番がアンロックされます。