@rozoai/checkout 0.1.15 → 0.1.16

package/README.md

@@ -430,7 +430,23 @@ rozo-checkout status <rozoPaymentId> --watch --timeout 900 --json   # poll every
 ```
 
 Exit 0 means the check itself ran cleanly, not that the invoice settled:
-`expired_unfunded` also exits 0. Always read `state`.
+`expired_unfunded` also exits 0. Always read `state`, or the simpler
+`paymentOutcome` and `nextAction` fields.
+
+For a yes/no answer, use `receipt`. It exits 0 only when Coinbase itself
+reports the invoice paid (v3 `CAPTURE_SUCCEEDED`), 3 while the payment is in
+flight or unknown, and 1 if the order expired unpaid or needs a human:
+
+```bash
+rozo-checkout receipt <rozoPaymentId> --json | jq '.receipt | .paymentOutcome, .merchantSettlement.status'
+```
+
+It reports your payment, the merchant invoice and service delivery as separate
+layers. Delivery is always `unknown`: Rozo cannot see your OpenRouter credits.
+
+With `--send`, the wallet must also hold the chain's fee coin (ETH, BNB, POL or
+SOL). If it does not, the CLI stops with `INSUFFICIENT_GAS` before signing and
+tells you how much is missing; the order is left untouched.
 
 **Retrying without paying twice.** Running `pay` again on the same link does
 not create a second order while its order is open: you get the same order
@@ -498,6 +514,16 @@ The full list of what this refuses to do, and why, is in
 
 ## Changelog
 
+- **0.1.16**: new `receipt` command: one read, exit 0 only when the merchant
+  side itself reports the invoice paid (Coinbase v3 `CAPTURE_SUCCEEDED`, v1 usage
+  count, or the Bitrefill payout), reported as three layers
+  (your payment, merchant invoice, service delivery). `status` adds
+  `paymentOutcome`, `nextAction` and `sendWindow`; `nextAction.canSend` is the
+  only field that permits paying. With `--send`, the wallet's fee coin (ETH,
+  BNB, POL, SOL; on Base including the L1 data fee) is checked before signing:
+  `INSUFFICIENT_GAS` says how much is missing and leaves the order untouched.
+  Transaction hashes this tool reports are no longer masked; anything inside
+  error text still is.
 - **0.1.15**: corrected guidance after an order expires unpaid. First check
   your own wallet that nothing was sent to the old deposit and no Lightning
   payment is pending; if nothing was sent, re-run the same `pay` on the same

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rozoai/checkout",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "type": "module",
   "description": "Pay OpenRouter, or any Coinbase invoice, with the crypto you already hold: USDT/USDC on Solana, BNB Chain, Ethereum or Polygon, USDC on Base or Stellar, or BTC over Lightning. No Coinbase account.",
   "license": "MIT",