@bitpal/checkout 0.9.0 → 0.10.0

package/README.md

@@ -180,6 +180,7 @@ app.post(
 | `checkout.session.expired` | Session expired unpaid |
 | `checkout.session.unresolved` | Underpaid / overpaid / wrong token — needs review |
 | `checkout.refund.recorded` | An on-chain auto-refund (over / under / late payment) was recorded |
+| `x402.payment.resolved` | An x402 payment that `/settle` left unresolved was later settled on-chain (see below) |
 
 ### ⚠️ Replay defense + at-least-once delivery
 
@@ -227,6 +228,12 @@ handler with `X-PAYMENT-RESPONSE` set. The middleware also does what the API can
   timeout — answers `503` and asks for a retry with the *same* header. Handing back a `402` there
   would make the caller re-sign and pay twice.
 
+When `/settle` answers `503`, nobody knows yet whether the money moved — so BitPal watches the chain
+and tells you how it ended with a **`x402.payment.resolved`** webhook (`status`: `confirmed` |
+`reverted` | `expired`, plus `payment_id` and `tx_hash`). It fires only on that path: the normal case
+already returned the result to you, and you should not have to handle the same outcome twice. Verify
+it exactly like a checkout webhook.
+
 Not on Express? `X402Gate` is the framework-neutral core — give it the header and the resource URL,
 it tells you whether to bill or serve. On a `settled` result, call `commit()` once you have delivered
 the response, or `release()` if you could not.

package/dist/index.cjs

@@ -351,7 +351,12 @@ var CHECKOUT_WEBHOOK_EVENTS = [
   "checkout.session.settled",
   "checkout.session.expired",
   "checkout.session.unresolved",
-  "checkout.refund.recorded"
+  "checkout.refund.recorded",
+  // x402 결제의 **사후** 확정. 정상 경로(/settle 이 그 자리에서 결과를 반환)는 발행되지 않는다 —
+  //   이미 아는 결과를 중복으로 받지 않게 하기 위함이다. /settle 이 503 을 반환해 결과를 모른 채
+  //   남았을 때, reconciler 가 체인을 보고 종결시키면 이 이벤트가 온다.
+  //   payload: { payment_id, status: 'confirmed'|'reverted'|'expired', tx_hash, resource, amount, … }
+  "x402.payment.resolved"
 ];
 var WEBHOOK_HEADERS = {
   signature: "X-Webhook-Signature-256",

package/dist/index.d.cts

@@ -584,7 +584,7 @@ declare class BitPalError extends Error {
 /**
  * BitPal 이 발송하는 webhook 이벤트 타입 전체 목록.
  */
-declare const CHECKOUT_WEBHOOK_EVENTS: readonly ["checkout.session.created", "checkout.session.deposit_detected", "checkout.session.paid", "checkout.session.settled", "checkout.session.expired", "checkout.session.unresolved", "checkout.refund.recorded"];
+declare const CHECKOUT_WEBHOOK_EVENTS: readonly ["checkout.session.created", "checkout.session.deposit_detected", "checkout.session.paid", "checkout.session.settled", "checkout.session.expired", "checkout.session.unresolved", "checkout.refund.recorded", "x402.payment.resolved"];
 type CheckoutWebhookEvent = (typeof CHECKOUT_WEBHOOK_EVENTS)[number];
 /**
  * Canonical envelope (HTTP body).

package/dist/index.d.ts

@@ -584,7 +584,7 @@ declare class BitPalError extends Error {
 /**
  * BitPal 이 발송하는 webhook 이벤트 타입 전체 목록.
  */
-declare const CHECKOUT_WEBHOOK_EVENTS: readonly ["checkout.session.created", "checkout.session.deposit_detected", "checkout.session.paid", "checkout.session.settled", "checkout.session.expired", "checkout.session.unresolved", "checkout.refund.recorded"];
+declare const CHECKOUT_WEBHOOK_EVENTS: readonly ["checkout.session.created", "checkout.session.deposit_detected", "checkout.session.paid", "checkout.session.settled", "checkout.session.expired", "checkout.session.unresolved", "checkout.refund.recorded", "x402.payment.resolved"];
 type CheckoutWebhookEvent = (typeof CHECKOUT_WEBHOOK_EVENTS)[number];
 /**
  * Canonical envelope (HTTP body).

package/dist/index.js

@@ -292,7 +292,12 @@ var CHECKOUT_WEBHOOK_EVENTS = [
   "checkout.session.settled",
   "checkout.session.expired",
   "checkout.session.unresolved",
-  "checkout.refund.recorded"
+  "checkout.refund.recorded",
+  // x402 결제의 **사후** 확정. 정상 경로(/settle 이 그 자리에서 결과를 반환)는 발행되지 않는다 —
+  //   이미 아는 결과를 중복으로 받지 않게 하기 위함이다. /settle 이 503 을 반환해 결과를 모른 채
+  //   남았을 때, reconciler 가 체인을 보고 종결시키면 이 이벤트가 온다.
+  //   payload: { payment_id, status: 'confirmed'|'reverted'|'expired', tx_hash, resource, amount, … }
+  "x402.payment.resolved"
 ];
 var WEBHOOK_HEADERS = {
   signature: "X-Webhook-Signature-256",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitpal/checkout",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "BitPal Checkout SDK — non-custodial crypto checkout: create sessions, issue per-order deposit addresses, poll status, verify signed webhooks, and charge per API call with x402.",
   "license": "MIT",
   "repository": {