テスト用Stripe互換モックAPI（無料）

概要

StripeのパブリックREST APIと同じ形状のJSONを返すHTTP APIです。フィールド名、IDプレフィックス（cus_、ch_、pi_、sub_、in_）、カーソルページネーション、整数の通貨最小単位、Unixタイムスタンプ、Stripe形式のエラーエンベロープまで揃えています。読み取りは決定的（deterministic）で、毎回同じデータが返るためスナップショットテストに使えます。書き込みは形状の正しいオブジェクトを返しますが、保存はされません。

ユースケース：消費するJSONの形状を実際に叩いて確認する、Webhookの署名検証をend-to-endでテストする、実Stripeのテストカードでは出しづらい失敗パターン（card_declined / rate_limited / timeout）をシミュレートする、Stripeアカウントを開設する前にフローをデモするなど。

クイックスタート

最初の3件のchargeを取得してみてください。認証は不要です。

curl https://mockapihub.com/api/stripe/charges?limit=3

const res = await fetch(
  "https://mockapihub.com/api/stripe/charges?limit=3"
);
const { data, has_more } = await res.json();
console.log(data[0].id); // -> "ch_..."

import requests
res = requests.get(
    "https://mockapihub.com/api/stripe/charges",
    params={"limit": 3},
)
data = res.json()["data"]
print(data[0]["id"])  # -> "ch_..."

利用可能なエンドポイント

すべてのパスでStripeと同じカーソルパラメータ（limit、starting_after、ending_before）に対応しています。

Webhookシミュレーション

自分が管理する公開HTTPSのURLに、署名付きStripe形式イベントを送信できます。webhook.site や RequestBin と組み合わせれば、すぐに受信箱を用意できます。

# 1. Grab a free inbox URL (no signup):
#    https://webhook.site/ → copy the unique URL

# 2. Tell us to send a Stripe-shaped event there:
curl -X POST https://mockapihub.com/api/stripe/webhooks/trigger \
  -H 'Content-Type: application/json' \
  -d '{
    "event_type": "charge.succeeded",
    "target_url": "https://webhook.site/<your-uuid>"
  }'

# 3. Refresh webhook.site — the signed event has arrived.
#    The Stripe-Signature header verifies against the secret below.

制限：トリガー呼び出しはIPあたり毎分10回、1回あたり最大5イベントまで。target_url は公開HTTPSのみ許可。プライベート/内部アドレスはリクエスト時点とDNS解決後の二段階で拒否します。

対応イベントタイプ： charge.succeeded, charge.failed, customer.created, payment_intent.succeeded, payment_intent.payment_failed, invoice.paid, customer.subscription.created, customer.subscription.deleted

失敗シミュレーション

カオスクエリパラメータは /api/stripe/* のすべてのエンドポイントで使えます。特殊なStripeテストカードやテストクロックを用意せずに、自分のコードのエラー処理パスを実行できます。

例： curl https://mockapihub.com/api/stripe/charges?simulate=card_declined は code: card_declined を含むStripe形式の402を返します。

実Stripe APIとの違い

• 永続化されません。 読み取りは決定的（同じデータが返る）。書き込みは形状の正しいレスポンスを返しますが、その後のGETでは見つかりません。
• 実認証はありません。 全エンドポイントは公開です。sk_test_* キー、Bearerトークン、idempotency-keyの検証などは行いません。
• 実際の決済は発生しません。 課金が「成功」するのは私たちがそう言うからで、カード決済処理には到達しません。
• 対応リソースは限定的です。 customers / charges / payment_intents / subscriptions / invoices と Webhookのみが対象です。
• レスポンス形状は実Stripeから乖離する可能性があります。 Stripeは新フィールドを継続的に追加しているため、すべてのマイナーバージョンに完全追随はできません。最終確認日：2026-05-13。

よくあるユースケース

• Stripeアカウントなしで、Webhookの署名検証をテストする。
• Stripe SDKを採用する前、またはアカウント審査待ちの間に、チェックアウトUIを試作する。
• card_declined / rate_limited / タイムアウト などの失敗パスを、テストカードのやりくりなしで実行する。
• Stripe形式のJSONを扱うコードの、決定的なCIフィクスチャとして使う。
• デモ環境 — セールスエンジニアがキー・ダッシュボード・ライブアカウントなしでStripe連携をデモする。

よくある質問