@siglume/direct-request-payment 0.3.1 → 0.3.2

package/README.md

@@ -64,11 +64,29 @@ Current HTTP endpoints live under Siglume's market/API Store route namespace for
 compatibility with the existing platform contract. That does not make this SDK an
 API Store publishing SDK.
 
-## Trial Pricing
+## SDRP Payment Menu Boundary
+
+SDRP is the overall protocol name. This SDK covers **Standard Payment** for
+external merchants: checkout, subscription, and scheduled-autopay flows that
+settle through the ordinary DirectPaymentHub wallet-payment rail.
+
+The new API Store small-payment menus are separate from this SDK:
+
+| SDRP menu | Amount band | Settlement behavior | SDK boundary |
+| --- | --- | --- | --- |
+| Standard Payment | Over JPY 500 / over USD 3.00, or immediate finality required | Buyer confirms payment; DirectPaymentHub settles on-chain immediately | Covered by `@siglume/direct-request-payment` |
+| Micro Payment | JPY 50-500 / about USD 0.30-3.00 | API Store meter gate before provider execution; weekly delayed settlement | Use the API Store flow, not this merchant checkout SDK |
+| Nano Payment | Under JPY 1 to JPY 49 / under USD 0.01 to about USD 0.30 | API Store meter gate before provider execution; monthly delayed settlement | Use the API Store flow, not this merchant checkout SDK |
+
+Micro Payment and Nano Payment do not execute an on-chain payment during the
+provider API call. If the buyer has no valid metered budget, scope, or remaining
+limit, Siglume records `rejected_no_charge` and does not call the provider API.
+
+## Standard Payment Merchant Pricing
 
 Siglume Direct Request Payment is currently offered with trial-phase merchant
 pricing designed for small EC sites, booking services, membership services, paid
-APIs, and agent-to-agent payment experiments.
+APIs, and external scheduled-payment experiments.
 
 Both launch settlement currencies are first-class: JPY settled in JPYC, and USD
 settled in USDC. A merchant settles in one currency, chosen at onboarding. The

package/docs/announcement-ja.md

@@ -6,7 +6,7 @@ Siglume Direct Request Payment 向けの外部事業者用SDKを公開しまし
 - PyPI: https://pypi.org/project/siglume-direct-request-payment/
 - GitHub: https://github.com/taihei-05/siglume-direct-request-payment
 
-このSDKは、外部EC、予約サービス、会員制サービス、API販売、AtoAの都度課金などで、Siglumeウォレット決済を自社プロダクトに組み込むためのSDKです。
+このSDKは、外部EC、予約サービス、会員制サービス、有料API、scheduled autopay などで、SDRP の Standard Payment / 通常決済を自社プロダクトに組み込むためのSDKです。
 
 ## できること
 
@@ -23,6 +23,18 @@ Siglume Direct Request Payment 向けの外部事業者用SDKを公開しまし
 
 Developer Portal の `cli_` API key を使うSDKではありません。導入設定は merchant の Siglume JWT、支払い作成は buyer の Siglume JWT で行います。
 
+## SDRP内の位置づけ
+
+SDRP は全体プロトコル名です。このSDKは外部merchant向けの Standard Payment / 通常決済を扱います。
+
+| SDRPメニュー | 金額帯 | 精算 |
+| --- | --- | --- |
+| Standard Payment / 通常決済 | JPY 500超 / USD 3.00超、または即時finalityが必要な決済 | DirectPaymentHubで即時オンチェーン分配 |
+| Micro Payment / マイクロペイメント | JPY 50-500 / 約USD 0.30-3.00 | API Storeのmeter gate後、週次後精算 |
+| Nano Payment / ナノペイメント | JPY 1未満-49 / USD 0.01未満-約USD 0.30 | API Storeのmeter gate後、月次後精算 |
+
+Micro Payment / Nano Payment はこのMerchant SDKのcheckout flowではありません。API実行前にAPI Store側のmeter gateを通し、予算やscopeに失敗した場合は `rejected_no_charge` として記録され、provider APIは呼ばれません。
+
 ## 最短導入
 
 ```ts

package/docs/api-reference.md

@@ -228,6 +228,10 @@ Thin wrapper around the current Siglume Direct Request Payment HTTP contract.
 Use it with the authenticated buyer's Siglume bearer token. Developer Portal
 `cli_` API keys are not accepted by these buyer-authenticated routes.
 
+This client creates SDRP Standard Payment requirements for external merchant
+checkout flows. API Store Micro Payment and Nano Payment use the API Store meter
+gate and are not created through this merchant checkout client.
+
 Payment requirements include `fee_bps` from the Siglume platform. The SDK does
 not calculate merchant plan fees locally; see [Pricing](./pricing.md).
 

package/docs/merchant-quickstart.md

@@ -14,6 +14,12 @@ external merchant.
 The merchant server must not create charges with a customer wallet. It signs the
 order challenge; the buyer-facing Siglume payment flow pays it.
 
+This quickstart is for SDRP Standard Payment in an external merchant product. If
+you are publishing a Siglume API Store listing that should use Micro Payment or
+Nano Payment, use the API Store flow instead. Micro/Nano run a server-side meter
+gate before provider execution and settle later; they are not browser checkout
+requirements created by this merchant SDK.
+
 ## 1. Run Merchant Setup
 
 Run setup from the merchant server, CI, or an integration agent with the

package/docs/pricing.md

@@ -1,10 +1,14 @@
 # Pricing
 
 This page documents the trial-phase merchant pricing for Siglume Direct Request
-Payment as of 2026-06-12. Pricing can change by agreement or future product
+Payment as of 2026-06-18. Pricing can change by agreement or future product
 release; the Siglume platform response is the source of truth for per-payment
 fee data returned at runtime.
 
+These prices apply to **SDRP Standard Payment** through the external merchant
+Direct Request Payment SDK. They do not apply to API Store Micro Payment or Nano
+Payment usage events.
+
 ## Settlement Currencies
 
 Siglume Direct Request Payment launches in the US and Japan, and both settlement
@@ -18,6 +22,22 @@ percentage (the payment fee column below) is identical in both currencies. Only
 the flat amounts — the monthly base fee and the per-payment minimum fee — are
 quoted per currency.
 
+## SDRP Menu Boundary
+
+SDRP is the protocol family. This SDK is for external-merchant Standard Payment:
+one buyer-approved payment, subscription charge, or scheduled-autopay occurrence
+settles through DirectPaymentHub.
+
+| SDRP menu | Amount band | Fee model | Settlement cadence |
+| --- | --- | --- | --- |
+| Standard Payment | Over JPY 500 / over USD 3.00, or immediate finality required | Merchant plan percentage with JPY 30 / USD 0.20 minimum | Immediate ordinary wallet settlement |
+| Micro Payment | JPY 50-500 / about USD 0.30-3.00 | USD 0.01 / accepted Tx, about JPY 2 | API Store internal meter, weekly delayed settlement |
+| Nano Payment | Under JPY 1 to JPY 49 / under USD 0.01 to about USD 0.30 | USD 0.001 / accepted usage, about JPY 0.2 | API Store internal meter, monthly delayed settlement |
+
+For Micro Payment and Nano Payment, the API Store meter gate runs before provider
+execution. Budget or scope failures are recorded as `rejected_no_charge`; the
+provider API is not called and no pending provider revenue is created.
+
 ## Trial Plans
 
 | Plan | Monthly fee (JPY) | Monthly fee (USD) | Payment fee | Intended starting point |
@@ -70,4 +90,4 @@ The trial pricing is intended for:
 - Booking and reservation services
 - Membership services
 - Paid API access
-- Agent-to-agent payment experiments
+- Scheduled autopay for external merchant workflows

package/docs/security.md

@@ -106,5 +106,9 @@ Direct Request Payment is not:
 - escrow
 - a platform balance
 - a card payment fallback
+- the API Store Micro Payment or Nano Payment meter
 
-It is a one-request wallet payment gate backed by an on-chain receipt.
+It is a Standard Payment wallet gate backed by an on-chain receipt. API Store
+Micro Payment and Nano Payment are separate internal-meter, delayed-settlement
+menus; they must fail closed before provider API execution when the buyer's
+metered budget, scope, or amount band is invalid.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siglume/direct-request-payment",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Merchant SDK for Siglume Direct Request Payment checkout integrations",
   "keywords": [
     "siglume",