決済失敗後の案内をCodexで作った。成功通知と古い下書きの扱いを検証
決済に失敗した注文へ、支払状況の確認メールを用意する。その間に再試行が成功していたら、最初の失敗記録だけを見て案内するわけにはいきません。
Dignowaでは、架空の14注文と24件の決済イベントを使い、Codexで照合処理と案内下書きを作成しました。最初に出力した下書きは1件。その注文へ後から成功イベントを加えると、新しい下書きは0件になり、以前の下書きも最新結果との照合で使用不可と判定できました。
この記事はDignowa編集部の実験報告です。実装・実行はCodexが担当しました。接続先はPC内に作った模擬APIで、実際の決済サービスではありません。決済、返金、メール送信、会計上の消込は行っていません。
決済方法を変えても、照合作業は残る
Coopelのakippa導入事例では、決済エラーが起きた場合の請求と入金について説明されています。銀行振込からメールリンク決済へ変更した後も消込作業が残り、決済処理データの取得や照合を自動化したという内容です。
同社はDignowaの顧客ではありません。今回の注文、金額、例外条件、APIの形式は独自に作った架空データです。出典に記載された削減時間を、今回の実績として扱ってはいません。
途中までしか取得できないとき、案内を作らない
模擬APIは6イベントずつ、4ページに分けてデータを返すようにしました。最初の実行では、2ページ目で503エラーを返し、再試行しても失敗する条件を入れています。
取得できたのは最初の6イベントだけでした。処理は合計3回のHTTPリクエストで停止し、照合結果も案内下書きも出力しませんでした。後ろのページに成功通知があるかもしれないため、取得できた部分だけで未払いとは決めない設計です。
次の実行では、2ページ目のエラーを一時的なものに変えました。1回再試行すると取得でき、合計5回のリクエストで全4ページ・24イベントを読み込めました。
これらは、取得失敗時の動きを確認するために意図して発生させたエラーです。実決済サービスで起きた障害を再現したという意味ではありません。
最後に届いた「失敗」で、前の「成功」を消さない
O11には、決済試行A11aが失敗した後に成功し、別の試行A11bが失敗する条件を作りました。最後に届いたイベントは失敗ですが、別の試行ですでに成功した記録があります。
比較用に、最後に届いたイベントだけで注文全体の状態を決める処理も実行しました。この方法ではO11を未払いと判定しました。O01のイベントを逆順に並べた場合も、古い失敗を最後に読み、未払いと判定しています。
今回の照合処理では、注文番号に加えて決済試行IDを分け、試行内の連番で履歴を確認します。O11とO01は成功候補になり、案内は作りませんでした。実顧客へ誤った案内を送った記録ではなく、判定方法を比べるための検証です。
「処理中」や「返金」を未払いへまとめない
O03は処理中のままです。成功とも失敗とも決めず、案内を作りませんでした。O08は成功後に返金イベントがあるため、確認待ちにしています。返金された金額を自動的に再請求する処理は入れていません。
O14は、異なる2つの決済試行が両方とも成功した条件です。請求額が同じだから片方を捨てるのではなく、複数成功として確認対象に残しました。返金の判断や実行はしていません。
| 分類 | 初回の結果 |
|---|---|
| 成功候補 | O01・O04・O11の3注文、計16,000円 |
| 未払い候補と案内下書き | O02の1注文、2,000円。未送信 |
| 処理中 | O03の1注文。案内なし |
| 確認が必要 | 金額違い・返金・複数成功など8注文 |
| 取消済み | O09の1注文。案内なし |
同じイベントの重複と、別の決済成功を区別する
O04には、同じ成功イベントE06を2回入れました。IDも内容も一致するため、一度だけ扱っています。
一方、O07では同じイベントIDの内容が「失敗」と「成功」で食い違うようにしました。片方を選ばず、その注文を確認待ちにしています。完全な重複と内容の競合は、別の状態として記録しました。
O05は注文5,000円に対して成功イベントが4,500円です。古い失敗イベントへ戻って案内することはせず、金額不一致で止めました。通貨、顧客ID、注文番号が違う条件も同様に確認対象へ分けています。
O12は失敗が確認できても、宛先がありません。この注文にも案内は作らず、宛先の確認事項として残しました。
成功が後から届くと、古い下書きはどうなるか
O02の成功イベントを追加し、25イベントの別データとして取得しました。同じ出力先へ保存しようとすると、入力が変わったことを検出して停止します。別の出力先で実行すると、成功候補は18,000円、新しい案内下書きは0件になりました。
ただし、最初に作ったO02のEMLファイルは残っています。今回の処理は履歴を保存するため、古い下書きを自動で消してはいません。
そこで、古い下書きの注文番号を最新結果と照合する処理も実行しました。O02は成功候補へ変わっているため、使用可否はfalseとなりました。
この判定で、外部のメールアプリからの送信まで止められるわけではありません。実運用では送信操作へこの確認を組み込み、送信直前の決済状態も取得する工程が必要です。今回はファイルの照合までを検証しています。
同じ入力で再実行しても、取得は省略しない
初回と同じデータで再実行した際も、4ページを再取得しました。そのうえで入力と保存済みの結果が変わっていないことを確かめ、追加出力は0件になっています。
ページの途中でデータの版が変わる条件では、2ページ目で停止しました。すでに取得したページの番号が再び返る条件でも停止し、無限に取得を続けませんでした。保存した結果を書き換えた条件では、通信を始める前に変化を検出しました。
Codexで作り、Pythonで動かした範囲
CodexがPythonの標準ライブラリで、模擬API、データ取得、照合、メール下書き、検査を実装しました。APIはhttp.server、取得はurllib.request、下書きはemail.messageを使っています。実際にPC内でHTTP通信を行い、下書きはEMLファイルとして保存しました。
入力は注文JSONと決済イベントJSONです。決済試行ID、イベントID、連番、金額、通貨、顧客ID、注文番号を照合します。生成AIは開発と実行に使い、支払状況の判定は決めたルールで行いました。
最終検証では、9回のコマンド実行、30回のHTTP読み取り、43項目の検査を実施しました。全14注文の状態と確認理由、下書きの宛先・注文番号・金額、成功追加後の変化、再実行を確かめています。模擬サーバーは検証後に停止しました。
今回のAI駆動開発では、支払案内を作れる条件と、作ってはいけない条件を小さな処理で試しました。成功候補16,000円は模擬イベントと注文の照合結果であり、銀行へ着金した金額ではありません。実サービスの認証や仕様への対応、取得後に状況が変わる場合の送信制御、現場での時間削減は未検証です。
下書きと実行記録を確認する
14注文の照合一覧と、O02の未送信下書きを掲載しました。下書きの宛先は検証用のexample.invalidです。
コード・架空入力・実行記録のZIP、43項目の検査結果、30回のHTTP記録から、取得失敗を含む実行経緯を確認できます。古い下書きの再照合結果も別に残しています。