ap2_mandate_verifier 1.6.0 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.ja.md +102 -180
- data/README.md +126 -207
- data/docs/DIAGNOSTICS.ja.md +83 -2
- data/docs/DIAGNOSTICS.md +98 -2
- data/docs/LONG_PAYMENT.md +3 -1
- data/docs/PAYMENT_ACCEPTANCE.md +5 -0
- data/docs/PUBLIC_API.md +12 -1
- data/docs/RECURRING_PAYMENT.md +4 -2
- data/docs/RELEASE_160_CANDIDATE.md +1 -1
- data/docs/RELEASE_161_CANDIDATE.md +33 -0
- data/docs/RUBY_INTEGRATION.ja.md +208 -0
- data/docs/RUBY_INTEGRATION.md +225 -0
- data/docs/SUPPORT_CONTRACT.md +16 -3
- data/examples/integration/inputs.rb +169 -0
- data/examples/integration/processor.rb +39 -0
- data/examples/ruby_integration.rb +161 -0
- data/lib/ap2_mandate_verifier/payment.rb +27 -21
- data/lib/ap2_mandate_verifier/payment_acceptance.rb +59 -10
- data/lib/ap2_mandate_verifier/payment_diagnostics.rb +78 -0
- data/lib/ap2_mandate_verifier/payment_receipt.rb +14 -9
- data/lib/ap2_mandate_verifier/selective_payment.rb +14 -10
- data/lib/ap2_mandate_verifier.rb +1 -0
- metadata +9 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 9c2ce93037e11a4317d9c4c4f42ff1a9fccbe996277df3dcca9c34d41466de5f
|
|
4
|
+
data.tar.gz: 286a66784e21aa6de46d3efef055abd759e84147fe5593b224afada65b9e6902
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: ec58dc924497469507f0d64584130188cd3bfa0af356aef018f158025ee10013aa0f2ac2a20a920ceb3930799d4b99cad2a3d8a35e0129b6ca4215fbf9e66ae9
|
|
7
|
+
data.tar.gz: 1681af6d34ac0a7513c2cc5f6b5fedf7e7705f6a09ff61bf4e998eca8cd4a43e4f878095e46b9e3530bb93e68d74bc876ad94899e633921c86400a2bfa0ce005
|
data/README.ja.md
CHANGED
|
@@ -1,144 +1,122 @@
|
|
|
1
1
|
# AP2 Mandate Verifier — Checkout・PaymentのRuby SDK
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[English](README.md) · **公開済み安定版:1.6.1** · [Quick Start](docs/QUICK_START.ja.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
対応するAP2 Checkout・Payment MandateをRubyだけで発行・提示・検証できます。
|
|
6
|
+
購入者が何を承認し、Agentが何を選べるか、署名済みの注文・支払いが条件を満たすかを
|
|
7
|
+
アプリで確認したいときに使います。Rails依存はありません。
|
|
8
|
+
**検証成功は購入・決済成功ではなく、SDKは決済を実行しません。**
|
|
6
9
|
|
|
7
|
-
```ruby
|
|
8
|
-
# Protected enrollment + current authority synchronization are application duties.
|
|
9
|
-
accepted = service.accept(**trusted_scope, mode: :conditional, verification_inputs: raw_inputs)
|
|
10
|
-
execution = service.start(ticket: accepted.ticket, verification_inputs: fresh_raw_inputs) if accepted.ticket
|
|
11
|
-
usage = store.usage(**trusted_series_scope) # reservations, not settlement
|
|
12
|
-
```
|
|
13
|
-
|
|
14
|
-
### 公開済み1.5.0:Payment受理の原子性と冪等性支援
|
|
15
|
-
|
|
16
|
-
保護された業務上の支払い単位を原子的に予約し、開始前に全検証をやり直します。応答消失・結果不明では自動再実行せず、元のReceiptを照合して復旧できます。[公開照合記録](docs/POST_RELEASE_150.md)。[組込み・永続store・安全性契約](docs/PAYMENT_ACCEPTANCE.md)、[Ruby単体の復旧例](examples/payment_acceptance.rb)、[公開前の確認](docs/RELEASE_150_CANDIDATE.md)。
|
|
17
|
-
|
|
18
|
-
```ruby
|
|
19
|
-
accepted = service.accept(**trusted_scope, mode: :conditional, verification_inputs: raw_inputs)
|
|
20
|
-
dispatch = service.start(ticket: accepted.ticket, verification_inputs: fresh_inputs) if accepted.ticket
|
|
21
|
-
# 実際のprocessor呼出しはアプリ側。同じdispatch.processor_keyを使います。
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
検証成功・永続予約・決済完了は別の事象です。承認済みoccurrenceの保護、全worker共通の永続store、processorの冪等性・照会が必要です。旧1.xのverifierは変更せず、SQLite参照driverは任意の別依存です。
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
### 公開済み1.4.0:PISPと支払い実行日時の条件
|
|
28
|
-
|
|
29
|
-
承認したPISPと実行可能期間を指定し、アプリが独立して確認した決済サービス・実行予定時刻と照合できます。日時は解析した瞬間で比較し、旧1.xの既定動作を維持します。[仕様・API・公式との差](docs/PAYMENT_POLICY.md)、[3方式のRuby例](examples/payment_policy.rb)、[公開照合記録](docs/POST_RELEASE_140.md)。
|
|
30
|
-
|
|
31
|
-
### 公開済み1.3.0:CheckoutとPaymentの選択的開示
|
|
32
|
-
|
|
33
|
-
承認済みの完全Openを安全に保持し、Checkoutの販売者・商品候補、Paymentの支払先・決済手段から必要な情報だけを提示できます。全必須条件と数量の検証を維持します。[仕様・API・Python差分](docs/SELECTIVE_CHECKOUT.md)、[Ruby単体の一連の例](examples/selective_checkout_payment.rb)、[公開照合記録](docs/POST_RELEASE_130.md)。
|
|
34
|
-
|
|
35
|
-
### 公開済み1.2.0:Payment候補の選択的開示
|
|
36
10
|
|
|
37
|
-
|
|
11
|
+
**対応環境:** MRI 3.4.12 / 4.0.9。既存の公開Gemネイティブ検証は**1.6.0**のLinux ARM64・AMD64、macOS Intel・Apple Silicon、Windows Server 2022 X64が対象で、新CLIの検証ではありません。[既存の検証範囲と再現方法](docs/PLATFORM_SUPPORT.md)と[1.6.1のLinux公開後検証](docs/POST_RELEASE_161.md)を分けて参照してください。Railsデモの対応範囲も別です。
|
|
38
12
|
|
|
13
|
+
## まず動かす
|
|
39
14
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
Direct/条件付きPayment Mandateと成功/エラーPayment Receiptを追加しました。[API・制約・信頼境界](docs/PAYMENT.md)、[Ruby単体サンプル](examples/payment.rb)、[公開照合記録](docs/POST_RELEASE_110.md)、[GitHub Release](https://github.com/cuichangquan/ap2-mandate-verifier/releases/tag/v1.1.0)。検証成功は実行許可ではなく、永続的・原子的な単発利用管理と実決済は利用アプリの責任です。
|
|
15
|
+
この最小SDK手順は**公開済み1.6.1**を使います。新CLIは[Gemだけで動かす組込み手順](docs/RUBY_INTEGRATION.ja.md)を使ってください。
|
|
43
16
|
|
|
44
17
|
```sh
|
|
45
|
-
gem install ap2_mandate_verifier --version 1.
|
|
46
|
-
|
|
18
|
+
gem install ap2_mandate_verifier --version 1.6.1
|
|
19
|
+
AP2_GEM_DIR="$(ruby -e 'puts Gem::Specification.find_by_name("ap2_mandate_verifier", "1.6.1").full_gem_path')"
|
|
20
|
+
ruby "$AP2_GEM_DIR/examples/conditional_checkout.rb"
|
|
21
|
+
ruby "$AP2_GEM_DIR/examples/payment.rb"
|
|
47
22
|
```
|
|
48
23
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
0.
|
|
55
|
-
|
|
56
|
-
[1.
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
##
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
[
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
24
|
+
Gem同梱例で合成鍵・承認を作り、Mandateの発行・提示・検証から、代替の成功/拒否Receiptの
|
|
25
|
+
真正性確認まで試せます。真正なError Receiptは失敗を通知します。
|
|
26
|
+
アカウント・認証情報・DB・Railsは不要です。対応Ruby導入済みなら約10分が目安です。
|
|
27
|
+
依存buildやDockerの初回取得には追加時間がかかる場合があります。
|
|
28
|
+
|
|
29
|
+
**次へ:** [手順と期待出力を示すQuick Start(1.6.0 baseline)](docs/QUICK_START.ja.md)で、
|
|
30
|
+
12のUTC月と累計JPY予算超過の拒否まで試せます。
|
|
31
|
+
[Dockerデモ](https://github.com/cuichangquan/ap2-mandate-verifier-demo#readme)も公開済み**1.6.0**を使用し、
|
|
32
|
+
ローカルのCheckout画面とRuby単体のPayment例を用意しています。
|
|
33
|
+
|
|
34
|
+
## 利用方式を選ぶ
|
|
35
|
+
|
|
36
|
+
**アプリへ組み込む場合:** [Ruby組込み・プロセス終了後の復旧ガイド](docs/RUBY_INTEGRATION.ja.md)で、
|
|
37
|
+
保護されたアプリ入力、模擬結果の永続化、別プロセス復旧、安全な再送判断を確認してください。
|
|
38
|
+
リポジトリ取得+公開1.6.0、または**公開済み1.6.1**の同梱CLIで実行します。
|
|
39
|
+
1.6.1のCLIにはリポジトリ取得が不要です。公開1.6.0には新CLIは含まれません。
|
|
40
|
+
[1.6.1の配布物と検証記録](docs/POST_RELEASE_161.md)を参照してください。
|
|
41
|
+
|
|
42
|
+
Checkoutは注文内容、Checkout Mandateはその承認・委任を表します。
|
|
43
|
+
Payment MandateはCheckout承認を参照し、支払い条件を追加します。
|
|
44
|
+
Receiptは元の最終Mandateに対するアプリの結果通知を認証するもので、精算を独立に証明しません。
|
|
45
|
+
|
|
46
|
+
| 方式 | 用途 | API/ガイド |
|
|
47
|
+
| --- | --- | --- |
|
|
48
|
+
| Direct | 購入者が確定した署名済み注文・支払いを承認する | `Buyer`、`Payment.issue_direct` · [Checkout](docs/BUYER_DIRECT_CHECKOUT.md)/[Payment](docs/PAYMENT.md) |
|
|
49
|
+
| 条件付き委任 | 購入者が候補と上限を承認し、登録済みAgentが範囲内で選ぶ | `ConditionalCheckout`、`Payment.issue_open/issue_closed/present` · [Checkout](docs/CONDITIONAL_CHECKOUT.md) |
|
|
50
|
+
| 選択的開示 | 完全な承認済みOpenを安全に保持し、販売者・商品または支払先・決済手段の選択候補だけ送る | `SelectiveCheckout`、`SelectivePayment` · [Checkout](docs/SELECTIVE_CHECKOUT.md)/[Payment](docs/SELECTIVE_PAYMENT.md) |
|
|
51
|
+
| 長期Open | 同じCheckout/Payment Openを明示UTC月で再利用し、有限回数・累計JPY予算を制限する | `LongPayment`、`PaymentAcceptance::LongSQLiteStore` · [契約](docs/LONG_PAYMENT.md) |
|
|
52
|
+
|
|
53
|
+
Direct/条件付きCheckoutは明示的な複数明細profileで1販売者・最大8明細と数量に対応します。
|
|
54
|
+
既定の単一商品profileは1明細の契約を維持します。選択的profileでも必須条件と数量は残り、
|
|
55
|
+
候補数・順序・issuer JWTのリンク可能性は隠しません。
|
|
56
|
+
長期Openは独立した完全開示profileです(content最大400日、提示証明は短命)。
|
|
57
|
+
選択的開示やPISP/日時profileとの合成は対象外です。
|
|
58
|
+
**UTC月次profileはAP2の汎用MONTHLY仕様への完全準拠を意味しません。**
|
|
59
|
+
|
|
60
|
+
ほかに明示的な[PISP/実行日時条件](docs/PAYMENT_POLICY.md)、
|
|
61
|
+
[原子的受理・復旧支援](docs/PAYMENT_ACCEPTANCE.md)、
|
|
62
|
+
短期の[ON_DEMAND回数/JPY予算profile](docs/RECURRING_PAYMENT.md)があります。
|
|
63
|
+
既存1.x APIの引数・既定値・profile・保存形式は維持します。
|
|
64
|
+
|
|
65
|
+
## 役割からAPIを選ぶ
|
|
66
|
+
|
|
67
|
+
| アプリ内の役割 | 入口 |
|
|
68
|
+
| --- | --- |
|
|
69
|
+
| 販売者バックエンド | `CheckoutJWT.sign`、`CheckoutReceipt.sign/verify` |
|
|
70
|
+
| 信頼された承認バックエンド | 同意前に`CheckoutJWT.verify`、`Buyer.issue_closed`または`ConditionalCheckout.issue_open`、対応するPayment発行 |
|
|
71
|
+
| 登録済みAgent | `Buyer.present_closed`または条件付きの`issue_closed/present`。対応profileでは選択的API。Provider秘密鍵は承認バックエンド内に保持 |
|
|
72
|
+
| 販売者・支払い検証側 | Directは`Buyer.verify`、条件付きCheckoutは`InputBuilder.prepare/restore/verify`、PaymentとCheckout結合は`Payment.verify`、選択的/長期は専用API |
|
|
73
|
+
| Receipt受信側 | `CheckoutReceipt.verify`、`PaymentReceipt.verify`。真正性と通知結果を両方確認 |
|
|
74
|
+
| 永続的なPayment受理を管理するアプリ | `PaymentAcceptance::Service`と対応する保護store。[組込み契約](docs/PAYMENT_ACCEPTANCE.md) |
|
|
96
75
|
|
|
97
|
-
|
|
76
|
+
`verify_checkout`(別名`verify_research`)は7入力の条件付きCheckout完全検証です。
|
|
77
|
+
業務レコードからの入力には`InputBuilder`を推奨します。
|
|
78
|
+
旧`verify(presentation_json:)`は構文検査のみで、成功Evidenceを返しません。
|
|
79
|
+
[厳密なAPI・結果・例外契約](docs/PUBLIC_API.md)を確認してください。
|
|
98
80
|
|
|
99
|
-
|
|
81
|
+
## 導入と対応環境
|
|
100
82
|
|
|
101
|
-
|
|
102
|
-
gem
|
|
103
|
-
|
|
83
|
+
正式対応は**MRI 3.4.12と4.0.9**です。今回の手順をGemfileで使う場合は
|
|
84
|
+
`gem "ap2_mandate_verifier", "= 1.6.0"`を指定します。
|
|
85
|
+
安定1.xを追うアプリでは`"~> 1.0"`を使いlockfile更新を確認できます。
|
|
86
|
+
`~> 0.8.0`は1.xを選択しません。[移行案内](docs/RELEASE_100.md)に互換性の詳細を残しています。
|
|
104
87
|
|
|
105
|
-
|
|
88
|
+
runtime依存はJSON 2.19.9、JWT 3.3.0、base64 0.3.0、OpenSSL gem 4.0.2、Digest 3.2.1に固定。
|
|
89
|
+
導入時に依存取得・native buildを伴う場合があります。衝突回避のために固定条件を緩めないでください。
|
|
90
|
+
解決可能なRuby範囲は全Ruby版・OS・providerの認証ではありません。[対応契約](docs/SUPPORT_CONTRACT.md)。
|
|
106
91
|
|
|
107
|
-
|
|
108
|
-
gem "ap2_mandate_verifier", "~> 1.0"
|
|
109
|
-
```
|
|
92
|
+
## アプリに組み込む前の責任境界
|
|
110
93
|
|
|
111
|
-
|
|
94
|
+
core verifierはネットワーク・決済を実行しません。任意のacceptance storeはローカルDBの
|
|
95
|
+
トランザクションを実行し、SQLite driverは別途導入が必要です。
|
|
96
|
+
**検証・永続予約・アプリの実行許可・精算はそれぞれ別です。**
|
|
112
97
|
|
|
113
|
-
|
|
98
|
+
本人認証・同意・保護された承認記録・独立した最新の信頼鍵/失効/profile policy・注文/Challenge状態・時計は
|
|
99
|
+
アプリの責任です。実行前に現在の権限を再照合し、単発利用状態を永続的・原子的に消費し、
|
|
100
|
+
不明結果を扱い、processorを呼ぶかを判断します。
|
|
101
|
+
SDK受理やReceipt認証は実Issuerの信頼やprocessorのexactly-onceを保証しません。
|
|
102
|
+
Receipt不在・不正・結果不明は照合待ちとし、timeout/Errorで自動再実行・枠の返却をしません。
|
|
114
103
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
104
|
+
未知・非対応形式は拒否します。例外・unavailable・結果なしは実行許可になりません。
|
|
105
|
+
秘密鍵・Mandate/nonce原文をログに出さず、保存したEvidenceを認証済み資格情報として扱わないでください。
|
|
106
|
+
一般AP2/全Schema準拠、実Issuer互換性、本番GOは主張しません。
|
|
107
|
+
[Issuer/Host責務](docs/ISSUER_HOST_MINIMUM_CONTRACT.md)、[安全性](SECURITY.md)、[受理支援の限界](docs/PAYMENT_ACCEPTANCE.md)。
|
|
118
108
|
|
|
119
|
-
|
|
120
|
-
bundle update ap2_mandate_verifier
|
|
121
|
-
```
|
|
109
|
+
## 詳細と保持した検証記録
|
|
122
110
|
|
|
123
|
-
|
|
111
|
+
- [公開API](docs/PUBLIC_API.md)、[InputBuilder](docs/INPUT_BUILDER.ja.md)、[診断](docs/DIAGNOSTICS.ja.md)。
|
|
112
|
+
- [1.6.0公開照合](docs/POST_RELEASE_160.md)、[変更履歴](CHANGELOG.md)、[公開・撤回履歴](docs/PROJECT_STATUS.md)、[保守方針](docs/POST_RELEASE_MAINTENANCE.md)。
|
|
113
|
+
- [販売者署名](docs/MERCHANT_SIGNING.md)、[複数明細](docs/MULTI_ITEM_CHECKOUT.md)、[Python差分](docs/MULTI_ITEM_INTEROP.md)。
|
|
124
114
|
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
`received_closed_sd_jwt`は受信した最終inline SD-JWT原文、`now`はアプリの時計です。
|
|
115
|
+
過去版・研究文書は当時の証拠として保持し、現在の導入経路とは区別します。
|
|
116
|
+
リポジトリの文書更新は公開済み1.6.0 Gemの再build・置換ではありません。
|
|
128
117
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
signed = signing.sign(checkout: checkout, signer: signing.es256_signer(private_key: key),
|
|
132
|
-
public_key_pem: key.public_to_pem)
|
|
133
|
-
# signed.jwtの原文を保持し、InputBuilderのhost_checkout_jwsへ渡します。
|
|
134
|
-
receipt = AP2MandateVerifier::CheckoutReceipt.sign(closed_sd_jwt: received_closed_sd_jwt,
|
|
135
|
-
issuer: "shop", outcome: "Error", error: "declined", error_description: "Application declined",
|
|
136
|
-
issued_at: now, signer: signing.es256_signer(private_key: key), public_key_pem: key.public_to_pem)
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
受信時は独立した信頼鍵・期待署名者・明示時刻範囲・対象Mandateの原文参照を照合します。
|
|
140
|
-
真正な拒否は `verified? == true`、`purchase_succeeded? == false` です。
|
|
141
|
-
[完全動作例](examples/merchant_signing.rb)と[対応原文形状・SDKとの差異](docs/MERCHANT_SIGNING.md)を参照してください。
|
|
118
|
+
<details>
|
|
119
|
+
<summary>source checkoutで試すInputBuilder(発展)</summary>
|
|
142
120
|
|
|
143
121
|
## InputBuilderの最小例
|
|
144
122
|
|
|
@@ -188,68 +166,12 @@ end
|
|
|
188
166
|
|
|
189
167
|
検証時に `prepare` をやり直したり、保存hash/参照を現在値に合わせて更新したりしないでください。注文・信頼情報・署名原文の変化は検出できるままにします。保存済みtrust JSONは `restore_trust` で再シリアライズせず読み戻せます。[完全例](examples/input_builder.rb)には正常・改ざん・期限切れがあり、[利用案内](docs/INPUT_BUILDER.ja.md)に業務field・原文復元・Railsモデル対応付けを示しています。
|
|
190
168
|
|
|
191
|
-
## 結果と責任境界
|
|
192
|
-
|
|
193
|
-
次の表は、InputBuilderまたは `verify_checkout` によるOpen → Agent Closedの
|
|
194
|
-
完全検証に適用します。Direct・Checkout・Receiptは、それぞれの `verified?` や
|
|
195
|
-
例外契約を維持します。[API別の結果・失敗契約](docs/PUBLIC_API.md#result-object-and-failure-contracts)を参照してください。
|
|
196
|
-
|
|
197
|
-
| 結果 | 意味と利用者の処理 |
|
|
198
|
-
| --- | --- |
|
|
199
|
-
| `:verified_research` / `:scoped_research_verified`、`success? == true` | 不変のEvidenceに固定profileの検査事実があります。購入を許可するかは、Hostが別途判断します。 |
|
|
200
|
-
| `:rejected`、`rejected? == true` | Evidenceなし。停止して `result.code` を確認します。 |
|
|
201
|
-
| `:unavailable`、`unavailable? == true` | Evidenceなし。停止します。依存・処理の失敗だけで業務入力が不正とは断定しません。 |
|
|
202
169
|
|
|
203
|
-
|
|
170
|
+
</details>
|
|
204
171
|
|
|
205
|
-
|
|
206
|
-
if (diagnostic = result.diagnostic)
|
|
207
|
-
puts diagnostic.to_h(locale: :ja) # 英語は :en
|
|
208
|
-
end
|
|
209
|
-
```
|
|
172
|
+
### 次の候補:Payment以降の診断
|
|
210
173
|
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
Gemは署名、支持する開示閉包、委任、購入/Host binding、制約・期限を検査します。Hostは認証済み・独立・最新のtrust/鍵/失効、注文・Challenge状態、時計を供給します。実行直前に現在状態と期限を再照合し、nonceの原子消費+注文CAS、不明結果の回復、最終許可・決済判断を担当します。`prepare`/`restore` は保存元の認証やnonce未使用を証明しません。
|
|
216
|
-
|
|
217
|
-
公開済み1.0.0は既定の単一商品profileと明示選択の[複数明細profile](docs/MULTI_ITEM_CHECKOUT.md)を維持し、条件付き発行には後者を使います。全候補開示と既存上限を守り、未知・非対応形式は拒否します。一般AP2/全Schema、実Issuer互換性、新しい選択的開示profile、Rails adapter、DB/決済実行、数値性能保証は対象外です。実Issuer・実Hostの本番GOとPhase 2-Bは引き続き別のHOLDです。
|
|
218
|
-
|
|
219
|
-
### APIの使い分け
|
|
220
|
-
|
|
221
|
-
| 入口 | 役割 |
|
|
222
|
-
| --- | --- |
|
|
223
|
-
| `ConditionalCheckout.issue_open/issue_closed/present` | 条件付き発行・原文提示。販売者による完全検証は別途必須です。 |
|
|
224
|
-
| `Buyer.issue_closed/present_closed/verify` | 確定注文を承認するDirect発行・構造確認を伴う提示・Directの完全検証。 |
|
|
225
|
-
| `CheckoutJWT.sign/verify` | 販売者のCheckout署名と、承認前の真正性確認。 |
|
|
226
|
-
| `CheckoutReceipt.reference/sign/verify` | 最終Mandate原文の参照計算、明示的なアプリ結果の署名、Receiptの真正性確認。 |
|
|
227
|
-
| `InputBuilder.verify(**business_information)` | 推奨業務情報経路。入力を組み立て、完全検証します。発行前準備・復元は上の例の別処理です。 |
|
|
228
|
-
| `verify_checkout(**inputs)` | 既存の7入力を直接渡すOpen → Agent Closedの完全検証。trust/selection/Host JSONも呼出側が渡します。 |
|
|
229
|
-
| `verify_research(**inputs)` | 同じ7入力検証経路の維持された名称。非推奨警告はありません。 |
|
|
230
|
-
| `verify(presentation_json:)` | 旧JSON構文検査のみ。成功Evidenceを返しません。 |
|
|
231
|
-
|
|
232
|
-
`InputBuilder.verify` の不足keywordを含む組み立て引数不正は `:rejected / :invalid_host_context`、組み立て中の依存・予期しない失敗は `:unavailable / :research_verification_unavailable` です。完全検証に入った後のcodeは維持します。一方、直接の `verify_checkout`/`verify_research` の不足・未知keywordは `:unavailable / :research_verification_unavailable` です。これらの非成功では、すべて `success? == false`、`evidence == nil` になります。形状・上限・Rubyの引数束縛上の注意は[正確な契約](docs/SUPPORT_CONTRACT.md#full-entry-and-required-inputs)を参照してください。
|
|
233
|
-
|
|
234
|
-
## 詳細リンク
|
|
235
|
-
|
|
236
|
-
- [1.xの公開API・失敗・profile・保存契約](docs/PUBLIC_API.md)。従来の部分検証APIも維持し、成功Evidenceを返さない意味を変えません。
|
|
237
|
-
- [業務情報の一連の利用とRails対応付け](docs/INPUT_BUILDER.ja.md)、[完全Ruby例](examples/input_builder.rb)、[変更前の例](examples/input_builder_before.rb)。
|
|
238
|
-
- [支持入力・上限・Result/Evidence契約](docs/SUPPORT_CONTRACT.md)、[Issuer/Host責務](docs/ISSUER_HOST_MINIMUM_CONTRACT.md)。
|
|
239
|
-
- [1.0.0 Release notes](docs/RELEASE_100.md)、[公開・撤回記録](docs/PROJECT_STATUS.md)、[変更履歴](CHANGELOG.md)。リポジトリREADMEの変更で公開Gemを再build・置換しません。
|
|
240
|
-
- [固定commitの旧7入力・保存FULL例](https://github.com/cuichangquan/ap2-mandate-verifier/blob/e0ab9fb21045e89fc58fb06145eeda4855b2dc54/README.ja.md#保存済み合成入力で試す)、[過去版の配布物・provider証拠](research/stable010_release_linux_package/README.md)、[過去の概念図](https://github.com/cuichangquan/ap2-mandate-verifier/blob/e0ab9fb21045e89fc58fb06145eeda4855b2dc54/README.ja.md#図で見るap2の概念)。履歴は保存していますが、現在の連携手順や対応範囲を広げる根拠ではありません。
|
|
241
|
-
- [脆弱性報告](SECURITY.md)、[保守方針](docs/POST_RELEASE_MAINTENANCE.md)、[製品方針](docs/PRODUCT_VISION.md)。秘密鍵・実Mandate・個人情報を報告に含めないでください。
|
|
242
|
-
|
|
243
|
-
MIT。[LICENSE](LICENSE)を参照。
|
|
244
|
-
|
|
245
|
-
### 購入側Direct Checkout(公開済み0.7.0)
|
|
246
|
-
|
|
247
|
-
`CheckoutJWT.verify`で承認前に販売者署名を検証し、Trusted Surfaceの
|
|
248
|
-
承認バックエンドから`Buyer.issue_closed`を呼びます。Shopping Agentは
|
|
249
|
-
`Buyer.present_closed`で提示し、販売者は`Buyer.verify`で検証します。
|
|
250
|
-
Receiptは`profile_ref: Buyer::PROFILE_REF`で生成・確認します。
|
|
251
|
-
1販売者・1〜8明細・複数商品と数量を一貫して扱えます。既存2profileと
|
|
252
|
-
Open→Agent ClosedのAPI契約は維持します。
|
|
253
|
-
[仕様・責任境界](docs/BUYER_DIRECT_CHECKOUT.md)と
|
|
254
|
-
[承認からReceiptまでの実行例](examples/direct_checkout.rb)を参照してください。
|
|
255
|
-
検証成功は購買権限や実決済成功を意味しません。[短い動作確認済みサンプル](docs/RELEASE_070.md)も参照してください。
|
|
174
|
+
1.7.0候補ではPayment・Receipt・受理結果の任意の診断と、呼び出しごとの
|
|
175
|
+
`start_with_diagnostic`を追加します。従来の`start`のExecution/nil契約は維持します。
|
|
176
|
+
この変更では未公開です。[診断ガイド](docs/DIAGNOSTICS.ja.md)に英日ヒント、真正なError Receipt、
|
|
177
|
+
結果不明の扱いと限界をまとめています。診断は再決済や利用枠解放の許可ではありません。
|