fix(agent-commerce): 与信と売上確定を区別し capture へ与信結果を引き渡す - #7032
Merged
dotani1111 merged 3 commits intoAug 7, 2026
Conversation
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (1)
🚧 Files skipped from review as they are similar to previous changes (1)
📝 WalkthroughWalkthrough
Changes決済認可と capture
Estimated code review effort: 4 (Complex) | ~45 minutes Sequence Diagram(s)sequenceDiagram
participant Client
participant UcpCheckoutController
participant AgentCheckoutCompletionService
participant PaymentHandler
participant Order
Client->>UcpCheckoutController: complete checkout
UcpCheckoutController->>PaymentHandler: exchangePaymentToken()
PaymentHandler-->>UcpCheckoutController: payment data or exception
UcpCheckoutController->>AgentCheckoutCompletionService: complete with resolved data
AgentCheckoutCompletionService->>PaymentHandler: authorize()
PaymentHandler-->>AgentCheckoutCompletionService: AUTHORIZED or COMPLETED
alt AUTHORIZED
AgentCheckoutCompletionService->>PaymentHandler: capture(authorization)
PaymentHandler-->>AgentCheckoutCompletionService: capture result
else COMPLETED
AgentCheckoutCompletionService->>Order: complete without capture
end
AgentCheckoutCompletionService->>Order: save payment reference
Possibly related PRs
Suggested labels: Suggested reviewers: Poem
🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 3
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In
`@src/Eccube/Service/AgentCommerce/CheckoutSession/AgentCheckoutCompletionService.php`:
- Line 180: 再開時の authorize 処理で、リクエストの paymentData に保存済みの PSP
参照をサーバー側からマージするよう更新してください。CheckoutSession の mergePaymentData と paymentReference
を利用し、transaction_id などの保存済み取引識別子がリクエスト値で上書きされない順序を維持してください。保存済み参照を省略した再開リクエストでも
authorize ハンドラへ同じ PSP 取引が渡されるテストを追加してください。
- Around line 130-138: AUTHORIZED 分岐の handler->capture() で PSP
例外をそのまま伝播させず、PaymentOutcome::failed() 相当の FAILED 結果へ変換して既存の failOrder()
経路で処理してください。capture 実行前に mergePaymentData() で保存した与信参照が rollback で失われないよう、各実ハンドラの
capture 実装または周辺の復旧処理を更新し、authorize() 再実行時にその参照を再利用できる状態を維持してください。
In `@src/Eccube/Service/AgentCommerce/Payment/AcpPaymentHandlerInterface.php`:
- Around line 46-47: Update the ACP authorize flow to catch exceptions from
redeemSharedPaymentToken() and return PaymentOutcome::failed() instead of
propagating them. Preserve the already-resolved transactionId and metadata in
the failed outcome, ensuring redemption failures trigger the existing
fail-closed payment transition rather than an HTTP 500.
🪄 Autofix
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro Plus
Run ID: 5eb57b41-4a82-4311-9af8-375eed2b0c1f
📒 Files selected for processing (13)
e2e/agent/acp-checkout.phpe2e/agent/ucp-checkout.phpsrc/Eccube/Service/AgentCommerce/CheckoutSession/AgentCheckoutCompletionService.phpsrc/Eccube/Service/AgentCommerce/Payment/AcpPaymentHandlerInterface.phpsrc/Eccube/Service/AgentCommerce/Payment/AgentCheckoutPaymentHandlerInterface.phpsrc/Eccube/Service/AgentCommerce/Payment/PaymentOutcome.phpsrc/Eccube/Service/AgentCommerce/Payment/PaymentOutcomeStatus.phpsrc/Eccube/Service/AgentCommerce/Payment/UcpPaymentHandlerInterface.phptests/Eccube/Tests/Service/AgentCommerce/CheckoutSession/AgentCheckoutCompletionServiceTest.phptests/Eccube/Tests/Service/AgentCommerce/Conformance/AgentCheckoutCoreConformanceTest.phptests/Eccube/Tests/Service/AgentCommerce/Discovery/UcpPaymentHandlerDiscoveryRegistryTest.phptests/Eccube/Tests/Service/AgentCommerce/Payment/AgentCheckoutPaymentHandlerRegistryTest.phptests/Eccube/Tests/Service/AgentCommerce/Payment/DefaultAgentPaymentMethodResolverTest.php
エージェントチェックアウトの決済ハンドラ契約に 2 つの欠落があった。sample-payment-plugin (EC-CUBE/sample-payment-plugin#54) のレビューで顕在化したもので、いずれも実 PSP を接続した ときに実害が出る。 1. 与信のみ (requires_capture) と売上確定済 (succeeded) を PaymentOutcomeStatus::COMPLETED へ潰していたため、オーケストレータは COMPLETED を受けると必ず capture を呼んでいた。 与信と売上が 1 度で完結する auto-capture 型 PSP を差し込むと capture が二重発行される。 → PaymentOutcomeStatus::AUTHORIZED を追加し、AUTHORIZED のときだけ capture を呼ぶ。 COMPLETED は「capture 済/不要」を表し、capture を呼ばずに確定する。 2. capture へ authorize の結果 (取引識別子・metadata) を渡す経路がなく、同じ paymentData を 再度渡していた。ハンドラは対象取引を支払データから導出し直すほかなく、ACP の Shared Payment Token のようなワンショット償還のトークンでは 2 度目の償還が失敗する。 → capture() の引数に authorize が返した PaymentOutcome を追加する。 併せて、中断・失敗時に PSP 参照を追跡できるようにする。 - PaymentOutcome::requiresAction()/pending()/failed() に transactionId を渡せるようにした (DTO 自体は元から保持していたが、ファクトリが受け取らず捨てていた)。 - payment_data には metadata に加えて transaction_id を保持し、capture 失敗時にも残す (与信済みの取引を照会・取消するために必要)。 - authorize が支払データを検証できない場合は fail-closed で failed を返す旨を interface に明記。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## 4.4 #7032 +/- ##
==========================================
+ Coverage 77.17% 77.61% +0.44%
==========================================
Files 564 595 +31
Lines 28082 29173 +1091
==========================================
+ Hits 21671 22642 +971
- Misses 6411 6531 +120
Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
nanasess
force-pushed
the
fix/agent-commerce-capture-contract
branch
from
August 6, 2026 08:57
627e565 to
70f6e8a
Compare
nanasess
added a commit
to nanasess/sample-payment-plugin
that referenced
this pull request
Aug 6, 2026
本体 EC-CUBE/ec-cube#7032 のレビュー指摘 (CodeRabbit) 対応。authorize() の第 3 引数として 中断前の complete で保持した PSP 参照 (transaction_id と metadata) が渡るようになったため、 再開時はトークンを再償還せずその取引を続行する (実 PSP の「既存 PaymentIntent を confirm」に相当)。 モックも渡された transaction_id を導出値より優先するようにし、ユニットで固定した。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
Note GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer. |
There was a problem hiding this comment.
Actionable comments posted: 1
🧹 Nitpick comments (1)
src/Eccube/Service/AgentCommerce/Payment/AgentCheckoutPaymentHandlerInterface.php (1)
62-76: 🗄️ Data Integrity & Integration | 🔵 Trivial | ⚡ Quick win
capture()の戻り値として許容するステータスを契約に明記してください。呼び出し側 (
AgentCheckoutCompletionService::runStateMachine()Line 142) はCOMPLETED以外のすべてを失敗として扱います。PENDINGを返す非同期 capture のハンドラは、failOrder()に入り、errorCodeがnullのため空のエラーメッセージになります。契約に「capture はCOMPLETEDまたはfailed()のみを返す」と明記してください。非同期 capture を将来許容する場合は、状態機械側の分岐を先に定義してください。📝 契約追記の例
* authorize と同様、PSP 通信の失敗は例外でなく {`@link` PaymentOutcome::failed()} で返し、 * **与信済みの取引識別子を保持する** (与信は PSP 側に残るため、取消・再 capture の照会に要る)。 + * + * 戻り値は {`@link` PaymentOutcome::completed()} または {`@link` PaymentOutcome::failed()} のいずれかとする。 + * これ以外のステータス (AUTHORIZED / REQUIRES_ACTION / PENDING) はオーケストレータが失敗として扱う。 *🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@src/Eccube/Service/AgentCommerce/Payment/AgentCheckoutPaymentHandlerInterface.php` around lines 62 - 76, Update the capture() contract documentation in AgentCheckoutPaymentHandlerInterface to state that it may return only COMPLETED or PaymentOutcome::failed(), and must not return PENDING. Keep asynchronous capture unsupported unless AgentCheckoutCompletionService::runStateMachine() is first updated with an explicit PENDING branch.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In
`@src/Eccube/Service/AgentCommerce/Payment/AgentCheckoutPaymentHandlerInterface.php`:
- Around line 46-60: Update all external plugin implementations of
AgentCheckoutPaymentHandlerInterface to match the new authorize() third argument
and required capture() third argument, preserving compatibility with the
interface to avoid fatal PHP signature errors. Update any plugin-facing fixtures
or adapters as needed, and add a migration note documenting the signature
changes and required implementation updates.
---
Nitpick comments:
In
`@src/Eccube/Service/AgentCommerce/Payment/AgentCheckoutPaymentHandlerInterface.php`:
- Around line 62-76: Update the capture() contract documentation in
AgentCheckoutPaymentHandlerInterface to state that it may return only COMPLETED
or PaymentOutcome::failed(), and must not return PENDING. Keep asynchronous
capture unsupported unless AgentCheckoutCompletionService::runStateMachine() is
first updated with an explicit PENDING branch.
🪄 Autofix
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro Plus
Run ID: bf576dda-01b8-459e-b1f9-ea63076892ec
📒 Files selected for processing (13)
e2e/agent/acp-checkout.phpe2e/agent/ucp-checkout.phpsrc/Eccube/Service/AgentCommerce/CheckoutSession/AgentCheckoutCompletionService.phpsrc/Eccube/Service/AgentCommerce/Payment/AcpPaymentHandlerInterface.phpsrc/Eccube/Service/AgentCommerce/Payment/AgentCheckoutPaymentHandlerInterface.phpsrc/Eccube/Service/AgentCommerce/Payment/PaymentOutcome.phpsrc/Eccube/Service/AgentCommerce/Payment/PaymentOutcomeStatus.phpsrc/Eccube/Service/AgentCommerce/Payment/UcpPaymentHandlerInterface.phptests/Eccube/Tests/Service/AgentCommerce/CheckoutSession/AgentCheckoutCompletionServiceTest.phptests/Eccube/Tests/Service/AgentCommerce/Conformance/AgentCheckoutCoreConformanceTest.phptests/Eccube/Tests/Service/AgentCommerce/Discovery/UcpPaymentHandlerDiscoveryRegistryTest.phptests/Eccube/Tests/Service/AgentCommerce/Payment/AgentCheckoutPaymentHandlerRegistryTest.phptests/Eccube/Tests/Service/AgentCommerce/Payment/DefaultAgentPaymentMethodResolverTest.php
🚧 Files skipped from review as they are similar to previous changes (7)
- src/Eccube/Service/AgentCommerce/Payment/PaymentOutcomeStatus.php
- tests/Eccube/Tests/Service/AgentCommerce/Conformance/AgentCheckoutCoreConformanceTest.php
- e2e/agent/acp-checkout.php
- e2e/agent/ucp-checkout.php
- src/Eccube/Service/AgentCommerce/Payment/UcpPaymentHandlerInterface.php
- src/Eccube/Service/AgentCommerce/Payment/PaymentOutcome.php
- src/Eccube/Service/AgentCommerce/Payment/AcpPaymentHandlerInterface.php
ttokoro20240902
requested changes
Aug 7, 2026
ttokoro20240902
left a comment
ttokoro20240902
left a comment
Contributor
There was a problem hiding this comment.
レビューしました。auto-capture 型 PSP での capture 二重発行と、capture へ与信結果が渡らない問題はいずれも実在し、修正の方向に異論はありません。負の入力・capture 失敗・ハンドラ例外を本体テストと E2E の両方で通しているのも良いと思います。CodeRabbit の Major 3 件は 70f6e8a で実装されていることをコードで確認しました。
その上で、ステートマシンに 4 点だけ確認したい点があります。詳細は該当行にインラインで書きました。
| # | 重大度 | 指摘 | 該当 |
|---|---|---|---|
| 1 | 中 | capture 失敗後の再試行（READY）では PSP 参照がハンドラへ渡らず、本 PR が REQUIRES_ACTION/PENDING で解決したワンショット問題が残る。プラグイン側コメントの「同一取引の再 capture を可能にする」がコアの経路と噛み合っていない | AgentCheckoutCompletionService.php:91,134 |
| 2 | 中 | capture 成功後に commitOrder() が投げると PSP は課金済みなのに transaction_id ごと巻き戻る。authorize()/capture() には「最後の砦」を入れたが commit には無い |
AgentCheckoutCompletionService.php:43 |
| 3 | 中 | capture の PENDING が一律「失敗」になり在庫が戻る。さらに failOrder() のメッセージが空文字になる |
AgentCheckoutCompletionService.php:142 |
| 4 | 中 | exchangePaymentToken() の「例外を投げてはならない」が PHPDoc だけで、UcpCheckoutController::resolvePaymentData() に受けが無い |
UcpPaymentHandlerInterface.php:46 |
2 と 3 は origin/4.4 で同じ分岐を確認したので本 PR の regression ではありません。ただし「capture を一級のステップとして契約化する」「500 で巻き戻さない最後の砦を置く」というのがこの PR の主題なので、ここで塞ぐか、契約の範囲を PHPDoc で明示するかを決められると良いと思います。
なお PaymentOutcome::needsCapture() は追加されていますが呼び出し元がありません（isSuccessful() も同様に未使用のまま AUTHORIZED を true にする意味変更が入っています）。ステートマシンは switch ($outcome->status) を直接使っているので、削除するかステートマシン側で使って判定源を一本化するのが良さそうです。
Contributor
|
実装の契約変更に合わせて、合意用 Issue #6777 の記載更新をお願いできればと思います。
// before
public function authorize(Order $order, array $paymentData): PaymentOutcome;
// 売上確定。authorize が COMPLETED を返した後にのみ呼ぶ。
public function capture(Order $order, array $paymentData): PaymentOutcome;
// after
public function authorize(Order $order, array $paymentData, array $paymentReference = []): PaymentOutcome;
// 売上確定。authorize が AUTHORIZED を返した後にのみ呼ぶ。
public function capture(Order $order, array $paymentData, PaymentOutcome $authorization): PaymentOutcome;
|
Contributor
Author
|
@dotani1111 agent-commerce 関連のタスクが一通り完了しましたら、一連の更新をしておきますね |
PR EC-CUBE#7032 のレビュー指摘 5 件に対応する。5 件はいずれも「docblock が主張する一般則」と 「実装した範囲」の差分に落ちていたため、範囲を実装で埋めるか、主張を実装に合わせて絞る。 - UCP の exchangePaymentToken() に砦を追加。状態機械の外 (controller) で呼ぶため CompletionService の authorize/capture 用の砦が効かず、ハンドラが契約に反して投げると HTTP 500 になっていた。controller で捕捉しビジネス系エラー (HTTP 200 + messages[]) へ 写像する。handler_id の重複登録 (デプロイ不備) は従来どおり伝播させる。 - capture が契約 (COMPLETED か FAILED) に反する status を返したときの正規化を追加。 PENDING は errorCode/errorMessage を持たないため、素通しすると空文字の ERROR が エージェントへ返っていた。契約違反はログへ残し明示的な失敗へ写像する。 - failOrder のメッセージ本文が空にならないようフォールバックを追加。 - PaymentOutcome から未使用の述語 3 つ (isSuccessful/needsCapture/needsAction) を削除。 needsCapture は本 PR で追加し呼び出し元ゼロ、isSuccessful は本 PR が AUTHORIZED を含む 意味へ変更したまま呼び出し元ゼロで、「commit してよい」と誤読される余地があった。 判定源は状態機械の switch に一本化する。 - docblock を実装に合わせて訂正。「最後の砦」の範囲を authorize/capture に限定し、 範囲外 (supports/getHandlerId・exchangePaymentToken・PurchaseFlow) を明記。 complete に再入できる 4 状態と、保持済み PSP 参照を渡すのが requires_action / in_progress からの再開に限られることを表で示す。capture() の PHPDoc には、ready からの 再試行が新規 authorize になるため、与信が残り再 authorize できない場合 (ACP の Shared Payment Token 等) は retryable=false を返す契約を明記。 テストは分岐ごとではなく不変条件ごとに書く。「保持した PSP 参照がハンドラへ渡るのは 在庫を保持したまま中断した状態からの再開時のみ」を再入 3 経路で検証し、capture 失敗後の ready 再試行が新規 authorize になることを固定する。従来は「参照が書かれる」テストと 「参照が読まれる」テストが個別にあり、両者が接続するテストが無かったため穴が残っていた。 検証: PHPUnit AgentCommerce 354 tests / 1344 assertions / 0 failures、 php-cs-fixer 0 件、PHPStan level 6 (AgentCommerce 配下) No errors。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
CI の rector が YieldDataProviderRector で指摘。既存の MinorUnitConverterTest::malformedAmountProvider() と同じく \Iterator + yield へ揃える。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
ttokoro20240902
approved these changes
Aug 7, 2026
Contributor
There was a problem hiding this comment.
指摘 5 件すべての対応を bd41395 のコードで確認しました。LGTM です。
- ready 再試行の扱いは契約として明文化（入口ステータス表 +
capture()のretryable=false指示）。「与信拒否でもtransaction_idは保存されるので、ready で渡すと死んだ取引を掴ませる」という反証は私の見落としでした - 砦の範囲を
authorize()/capture()に限定し、commit 失敗時に参照が巻き戻る点を既知の制約として明記 asCaptureFailure()/errorMessageFor()で capture の契約違反と空文字メッセージを解消resolvePaymentData()を?arrayにして controller 側に砦を実装PaymentOutcomeの述語 3 つを削除し、判定をswitch ($outcome->status)に一本化
追加された 5 つのテストがいずれも修正前に落ちることを実測されている点も良いと思います。
dotani1111
approved these changes
Aug 7, 2026
nanasess
added a commit
to nanasess/sample-payment-plugin
that referenced
this pull request
Aug 7, 2026
EC-CUBE/ec-cube#7032 のマージで決済ハンドラの契約が 2 点明確になったため追随する。 - **capture の戻り値は COMPLETED か FAILED のみ**。従来は authorize と写像を共用しており、 ゲートウェイが REQUIRES_CAPTURE / REQUIRES_ACTION / PROCESSING を返すと AUTHORIZED / REQUIRES_ACTION / PENDING をそのまま返していた。本体はこれらを失敗として扱うが、 errorCode / errorMessage が無いぶん理由を伝えられない。capture 専用の写像を分け、 非終端ステータスはログに残したうえで capture_unexpected_status の失敗へ畳む。 - **与信が残り再 authorize できない場合の capture 失敗は retryable=false**。本体には capture 単独の再実行入口が無く、ready からの再 complete は新規 authorize から始まる (保持した PSP 参照は渡らない)。ACP は入口が Shared Payment Token の償還でワンショット のため、ready へ戻しても再試行は必ず失敗し与信だけが残る。プロトコル別の captureFailureIsRetryable() で分岐し、ACP=false / UCP=true とする。UCP はエージェントが complete のたびに credential を送り直し exchange をやり直せるため再試行が成立する。 ゲートウェイが不可逆と判断した失敗 (金額不一致等) は、再 authorize できるプロトコルでも 再試行させないよう AND で畳む。capture の例外経路では metadata も引き継ぐようにした (取消・照会に要る)。 紛らわしかった toOutcome() は toAuthorizeOutcome() へ改名し、capture からの流用を防ぐ。 検証: PHPUnit 86 tests / 177 assertions / 0 failures、PHPStan level 6 No errors。 追加した 6 テストは修正前に落ちることを確認済み。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
エージェントチェックアウトの決済ハンドラ契約 (
AgentCheckoutPaymentHandlerInterface/PaymentOutcome) に 2 つの欠落があり、実 PSP を接続したときに実害が出ます。EC-CUBE/sample-payment-plugin#54 のレビューで顕在化したものを本体側で修正します。いずれもエージェントコマース (#6777 / #6776 / #6574) が 4.4 で導入した未リリースの API であり、既存の決済プラグイン (通常購入の
PaymentMethodInterface) には影響しません。破壊的変更 (決済ハンドラを実装するプラグイン向け)
AgentCheckoutPaymentHandlerInterfaceの 2 メソッドのシグネチャを変更しています。古いシグネチャのまま実装しているとインターフェース実装制約により fatal error になります (authorize()は第 3 引数にデフォルト値がありますが、実装側で省略すると同様に fatal です)。AgentCheckoutPaymentHandlerInterface/AcpPaymentHandlerInterface/UcpPaymentHandlerInterface) を実装するプラグインのみ。通常購入のPaymentMethodInterfaceを実装する既存の決済プラグインには影響しません。Constant::VERSIONは4.4.0-dev・4.4 のタグは未発行です。コア本体に具象実装はなく (テストダブルのみ・本 PR で更新済み)、リリース済みのプラグイン API を壊すものではありません。$paymentReferenceは再開 complete のときだけ中断前の PSP 参照 (transaction_idと metadata) が入り、初回は空配列です。capture()は$paymentDataから取引を導出し直さず$authorization->transactionIdを使ってください。移行の実例は EC-CUBE/sample-payment-plugin#54 を参照してください。修正 1: 与信 (authorized) と売上確定 (completed) を区別する
PaymentOutcomeStatus::COMPLETEDが「与信のみ (requires_capture)」と「売上確定済 (succeeded)」の両方を表していたため、AgentCheckoutCompletionServiceは COMPLETED を受けると必ずcapture()を呼んでいました。与信と売上が 1 度の通信で完結する auto-capture 型 PSP を差し込むと capture が二重発行されます。
PaymentOutcomeStatus::AUTHORIZEDを追加し、AUTHORIZED のときだけ capture を呼ぶ。COMPLETEDは「capture 済/不要」を表し、capture を呼ばずに注文を確定する。PaymentOutcome::authorized()を追加。修正 2: capture へ authorize の結果を引き渡す
capture()には authorize と同じ$paymentDataしか渡っておらず、authorize が返した取引識別子・metadata を引き継ぐ経路がありませんでした。ハンドラは対象取引を支払データから導出し直すほかなく、ACP の Shared Payment Token のようなワンショット償還のトークンでは 2 度目の償還が失敗します (実際に sample-payment で SPT が 1 決済につき 2 回償還されていました)。併せて: 中断・失敗時に PSP 参照を追跡できるようにする
PaymentOutcome::requiresAction()/pending()/failed()がtransactionIdを受け取れるようにした (DTO 自体は元から保持していたが、ファクトリが受け取らず捨てていた)。payment_dataへ metadata に加えてtransaction_idを保持し、capture 失敗時にも残す (与信済みの取引を照会・取消するために必要)。failed()を返す旨を interface に明記。トークン欠落を「異常でない」と解釈して無与信のまま受注確定する事故を防ぐ。UcpPaymentHandlerInterface::exchangePaymentToken()は complete の状態機械の外側 (controller のペイロード解決時) で呼ばれるため、例外を投げてはならない旨を明記 (投げるとビジネス系エラーでなく HTTP 500 になる)。AcpPaymentHandlerInterface::redeemSharedPaymentToken()はワンショットであり authorize 内で 1 度だけ呼ぶ旨を明記。結合 E2E の拡充
想定入力からしかテストを作っていなかったため、負の入力と capture 失敗の経路が一度も通っていませんでした。
e2e/agent/{acp,ucp}-checkout.phpに追加します。requires_escalationから復帰できない)acp-checkout.phpのAGENT_E2E_ITEM_ID既定値を UCP 側と揃えて2に修正 (id=1はvisible=0の規格でローカル実行が必ず失敗していた。CI は2を明示指定しているため CI には影響なし)検証
analyse src)No errorstests/Eccube/Tests/Service/AgentCommerceのうち本 PR の変更範囲 = CheckoutSession / Payment / Discovery / AgentCheckoutCoreConformance)追加したテストケース:
testAuthorizedOutcomeHandsTransactionReferenceToCapture— capture が authorize の取引識別子・metadata を受け取り、payment_dataに永続化されるtestAutoCaptureGatewayIsNotCapturedTwice— authorize が COMPLETED を返したとき capture を呼ばないtestCaptureFailureRollsBackStockAndKeepsAuthorizationReference— capture 失敗で引当を戻しつつ取引識別子は残す関連
🤖 Generated with Claude Code
Summary by CodeRabbit