イベントリファレンス

Jammが送信するすべてのWebhookイベントの一覧、各イベントの発火タイミング、推奨される対応、およびペイロードの構造です。

すべてのWebhookは同じエンベロープを使用します — イベントのデータはcontentに入り、event_typeが何が起きたかを示します（ワイヤー上ではEVENT_TYPE_で始まります。例：EVENT_TYPE_CHARGE_SUCCESS）。

⚠️ 注意: ペイロードを信頼する前に、必ず署名を検証してください — Signature Verificationを参照。

イベント一覧

対応が必要な主要フィールド

各イベントで永続化または分岐に使う主なフィールドです。フィールドごとの詳細はAPIリファレンスを参照してください。

• CHARGE_*

  • content.id（trx-*）
  • content.customer（cus-*）
  • content.error.code（CHARGE_FAILのみ）

• REFUND_*

  • content.transaction.id（trx-*）
  • content.refund.refund_id（rfd-*）
  • content.refund.amount_refunded
  • content.refund.error（REFUND_FAILEDのみ）

• CONTRACT_ACTIVATED

  • content.customer（cus-*）— off-session請求の準備完了としてマーク

• USER_ACCOUNT_DELETED

  • content.customer（cus-*）— 今後の請求を停止

イベントごとのcontentの形

• Charge（CHARGE_*）: 決済オブジェクト。CHARGE_FAILはerrorオブジェクトを追加します。
• Refund（REFUND_*）: ネストされた2つのオブジェクトtransaction（決済）とrefund。REFUND_FAILEDでは金額の代わりにrefundにerrorオブジェクトが入ります。
• Contract / account（CONTRACT_ACTIVATED、USER_ACCOUNT_DELETED）: customer（cus-*）をキーにした小さなオブジェクト。

Webhookの例

CHARGE_SUCCESSイベントのペイロード例です：

{
  "id": "mwh-...",
  "event_type": "EVENT_TYPE_CHARGE_SUCCESS",
  "signature": "sha256=...",
  "created_at": "2026-03-03T02:46:58.208489023Z",
  "content": {
    "id": "trx-...",
    "customer": "cus-...",
    "description": "Order #1234",
    "merchant_name": "Acme Inc.",
    "initial_amount": 4000,
    "discount": 0,
    "final_amount": 4000,
    "currency": "JPY",
    "processed_at": "2026-03-03T02:46:56.000000Z",
    "created_at": "2026-03-03T02:46:54.547789Z",
    "updated_at": "2026-03-03T02:46:58.015737Z"
  }
}