Codexで業務改善 014

決済失敗後の下書きをCodexで作り、後から成功した注文と照合した

執筆:Dignowa編集部公開:更新:読む目安:約4分

決済失敗の案内を用意する間に、再試行が成功していたらどうするでしょうか。Dignowaでは架空14注文と24件の決済記録をCodexで照合し、未送信の下書き1件を作りました。その注文に成功記録を追加すると、新下書きは0件、古い下書きは使用不可と判定した実験です。

実決済に接続せず、記録の取得と照合を試した

Coopelのakippaの事例には、決済エラー後の請求を銀行振込からメールリンク決済へ変えても、データ取得と消込の仕事が残ったと紹介されています。同社はDignowaの顧客ではなく、今回の注文・金額・API形式は独自の架空データです。

Coopelのakippa導入事例

CodexがPythonで模擬API、取得、照合、EML下書きを実装・実行しました。http.server、urllib.request、email.messageを使い、PC内で実際に通信しています。実決済、返金、消込、メール送信は行っていません。

途中6件だけの取得では、未払いの案内を作らない

模擬APIは6件ずつ4ページを返します。2ページ目でHTTP503が続く条件では、合計3要求で停止しました。最初の6件だけで後の成功を見落とさないよう、照合結果も案内も出力しません。

一時的なエラーに変えた次の実行では、1回再試行して5要求で全4ページ・24件を取れました。これらは意図した検査条件で、実サービスの障害を観測したものではありません。

最後の失敗、処理中、返金を同じ状態へまとめない

O11は試行A11aが失敗後に成功し、別のA11bが失敗しました。最後だけを見る比較は未払いと誤判定し、O01の逆順入力も同じ問題がありました。完成版は試行IDを分け、試行内の連番を見て、両注文へ案内を作りませんでした。

初回の判定 注文数・扱い
成功候補 O01・O04・O11の3注文、16,000円
未払い候補 O02の1注文、2,000円の未送信下書き
処理中 O03の1注文。案内なし
要確認 金額違い・返金・複数成功など8注文
取消 O09の1注文。案内なし

O08の成功後返金は再請求せず保留です。O14の異なる2試行の成功も片方を捨てず、返金判断へ進めていません。

O04の同じE06・同内容の重複は一度だけ扱い、O07の同IDで成功・失敗が違う記録は保留しました。O05の注文5,000円・成功4,500円も、古い失敗へ戻らず金額不一致として止めます。通貨、顧客ID、注文番号の違い、O12の宛先なしも確認対象です。

成功後に残る古い下書きは、最新結果で使用不可と判定する

O02の成功を加えた25件で別の保存先へ出すと、成功候補18,000円、案内0件です。同じ保存先には変更入力を上書きしません。

古いO02のEMLは履歴として残ります。注文番号を最新結果へ照合すると、使用可否はfalseになりました。ただし外部メールアプリからの送信を阻止する機能ではありません。実務では送信操作へ再照合を組み込み、直前の決済状態も取得する必要があります。

再実行でも取得し直し、全記録がそろってから判定する

同じ入力でも4ページを取り直してから、保存結果との一致を確認し、追加出力0件にしました。途中でデータの版が変わると2ページ目で停止し、同じページ番号が再び返る条件も止めます。保存結果の変更は通信前に検出しました。

注文JSONと決済JSONの試行ID、イベントID、連番、金額、通貨、顧客、注文を、決めたルールで照合します。生成AIは開発・実行に使いました。コマンドを9回実行し、HTTPで30回読み取りました。43項目の検査で全14注文、下書き、成功記録を追加した後の変化などを確認しています。模擬サーバーは検証後に停止しています。

成功候補16,000円は模擬記録との一致で、銀行への着金ではありません。実認証・サービス仕様、取得後の状態変化と送信制御、現場の時間削減は未検証です。下書きの宛先も検証用のexample.invalidです。

14注文の照合一覧

O02の未送信下書き

コード・架空入力・実行記録のZIP

43項目の検査結果

30回のHTTP記録

古い下書きの再照合結果

参考情報