カスタマーと契約

Buyerと、その請求の承認を表す2つのオブジェクト。

カスタマー

BuyerがOn-sessionフローを完了すると、Jammはカスタマー（IDの接頭辞はcus-）を作成します。カスタマーは加盟店の連携におけるそのbuyerを表します。On-sessionのレスポンスで返されるcus- IDを保存してください — 今後のoff-session請求で必要になります。

• アクティブなカスタマー: カスタマーの契約が有効化されると、そのカスタマーは「アクティブ」となり、加盟店はoff-sessionエンドポイントを使っていつでもそのカスタマーから引き落とすことができます。
• 非アクティブなカスタマー: カスタマーに有効な契約がない場合、そのカスタマーは「非アクティブ」であり、加盟店はoff-sessionエンドポイントで引き落とすことができません。

契約の有効化については次のセクションで説明します。

契約

契約とは、今後のoff-session請求でbuyerの銀行口座から引き落とすための、buyerによる承認です。単発（one-time）のon-session決済では契約は作成されません。oneTime: falseのon-session決済では作成されます。

⚠️ 重要: 契約はすぐには利用できません — 有効化される必要があります（buyerの銀行口座登録と認証が完了する必要があります）。カスタマーがoff-session請求の準備が整うと、JammはCONTRACT_ACTIVATED Webhookを送信します。それ以前にoff-session請求を試みないでください。

ライフサイクル

On-session（契約あり）  →  CONTRACT_ACTIVATED Webhook  →  Off-session請求

BuyerがJammアカウントを削除した場合、USER_ACCOUNT_DELETED Webhookが届きます — そのカスタマーへの請求の試行を停止してください。