LicenseChain

有料販売者の Webhook

Pay は、支払いライフサイクル イベントを HTTPS エンドポイントに配信します。 x-lc-pay-* ヘッダー。 これは、Core API アプリの Webhook とは別のものです (X-Webhook-Signature) およびミラー リダイレクト HMAC。

コア API Webhook のセットアップ: コア API Webhook。 多言語署名検証サンプル: API の例 (多言語).

イベントの種類

  • payment.confirmed — 入金完了（主な成功イベントの販売者が処理）
  • payment.pending — 支払いはまだ処理中です
  • payment.failed, payment.canceled — 失敗/購入者のキャンセル

プロダクションミラーの販売者が検証 x-lc-pay-signature、 受け入れる payment.confirmed、その後 と確認する POST https://pay.licensechain.app/api/checkout/mirror/validate マークを付ける前に 現地注文で支払い済み。見る ペイミラーAPI.

販売者の Webhook 配信ヘッダー

  • x-lc-pay-signature — HMAC-SHA256 署名
  • x-lc-pay-event-id — 一意のイベント ID
  • x-lc-pay-event-type — イベントタイプ
  • x-lc-pay-idempotency-key — 重複排除キー
  • x-lc-pay-timestamp — 署名付きタイムスタンプ

署名の検証

署名検証用のメッセージ形式:

{'{'}timestamp{'}'}.{'{'}rawJsonPayload{'}'}

Node、Python、Go、PHP、Ruby での実装は次のとおりです。 API の例 (多言語) (定時比較を推奨)。

配送動作

  • 配信が成功すると、エンドポイントが 2xx 応答を返して確認されます。
  • 失敗した配信は自動的に再試行されます。を使用してイベントを冪等として扱います x-lc-pay-idempotency-key.
  • 常に確認する x-lc-pay-signature イベントに取り組む前に。