本文へスキップ

ブログセキュリティ

決済機能を追加する前に確かめたい、請求・注文・取消のつながり

決済機能を足す前に、請求額の決め方、途中で失敗したときの取り消し、決済側の出来事の受け取り方、やり直しの扱いを確かめます。診断で見つかりやすい事故の芽をもとに、確認の根拠と未確認の扱い、直す時期の書き方まで示します。

つながった3つの輪から、下の2つの箱へ線が伸びる図。1本だけが箱に届かず垂れている。

自社のWebサービスにカード払いや月額課金を足すと、お金の記録が2か所にできます。注文や申し込み、契約といった自社の記録と、決済代行サービス側の記録です。この2つは別々の場所で、別々の時点で更新されるため、どちらか一方だけが進む瞬間があります。

決済代行サービスが引き受けてくれるのは、多くの場合、カード情報の扱いや支払いそのものです。自社の記録と決済側の記録が食い違わないようにするのは、自社の作りの側に残ります。

この記事では、決済機能を足す前に確かめておきたい「請求・注文・取消のつながり」を整理します。確認する項目を並べるだけでなく、どう確かめたか、確かめられなかったことは何か、いつ直すかまで書いた確認結果の見本(架空)もあわせて示します。

決済を足すと増える「3つの出来事」と「2つの記録」

請求・注文・取消は、別々に起きて、別々の場所に記録される

決済を足したサービスでは、大きく3つの出来事が起きます。

  • 請求: 与信(カードの利用枠を先に押さえること)、確定(実際に請求すること)、返金。
  • 注文: 注文や申し込みの作成と変更。
  • 取消: キャンセルや解約。

この3つは、自社の記録と決済代行サービス側の記録の両方で起きます。たとえば利用者がキャンセルすると、自社の記録は「キャンセル済み」になり、決済側では与信の取り消しや返金が行われます。どちらか片方だけが済んだ状態で処理が止まると、2つの記録が食い違います。

「完了画面が出た=支払いが記録された」ではない

利用者の画面、自社のサーバー、決済代行サービスの3者は、それぞれ別の時点で「成功」を判断しています。利用者の画面に完了と出ていても、自社のサーバーでの保存が失敗していることがあります。逆に、画面にはエラーと出ていても、決済側では支払いが済んでいることもあります。

決済側から自社に届く知らせを、この記事では「通知」と呼びます。支払いの失敗や返金のように、利用者の操作とは関係なく決済側で起きる出来事は、この通知で自社に伝わります。

下の図は申し込みを例に、3者がそれぞれ何をするかを示したものです。

申し込みの流れの図。利用者の画面が申し込みを送る。自社のサーバーと記録が注文を保存する。決済代行サービスが与信を取る。自社と決済代行サービスのあいだで途中で切れると、与信だけか注文だけが残る。支払いの失敗や返金は決済代行サービスで起き、通知で自社に届いて記録に反映する。

支払いの確定と取消でも、同じように途中で切れると記録が食い違います。

図1 流れごとの、途中で切れたときに残るもの

流れ3者がすること途中で切れたときに残るもの
申し込み申し込みを送る・注文を保存する・与信を取る与信だけ、または注文だけ
支払いの確定完了画面を見る・注文を「支払済」にする・請求を確定する決済側は確定、記録は未払い
取消キャンセルを押す・注文を「キャンセル済み」にする・与信の取り消しや返金をする記録はキャンセル、決済側は請求のまま

この記事で紹介する例は、決済まわりで見つかりやすい作りのパターンを一般化したもので、特定の案件の内容ではありません。

「追加する前に確かめておけば、把握しやすくなる(防ぎやすくなる)」という見せ方は筆者の整理です。確かめれば必ず事故を防げる、という意味ではありません。

確認1:請求額は、誰が、どこで、何から決めるか

金額は、画面から送られた値ではなく、サーバー側で決める

画面(ブラウザ)で計算した合計や、画面から送られてきた単価をそのまま決済に使う作りは、診断で見つかりやすいパターンの一つです。画面の計算とサーバーの計算が少しでも違えば、表示と記録と請求の金額がずれるおそれがあります。利用者が送る値を書き換えられる場合は、表示と違う金額で請求が確定するおそれもあります。

請求額は、サーバー側で、商品やプランの料金から計算するのが基本です。画面に出す金額は、サーバーが計算した結果を表示するだけにします。

金額の持ち主を1か所に決める

料金が複数の場所に書かれていると、料金を変えるたびに複数か所を合わせる必要があります。どこか1か所を直し忘れても、すぐには気づきにくくなります。

決済に頼む金額、自社に記録する金額、領収書に出す金額を、同じ1回の計算から作るようにしておくと、ずれる余地が小さくなります。どこが金額の持ち主なのかを、追加する前に決めておきます。

日付で決まるものも、同じように決めておきます。どの月の請求になるか、いつから有料になるかを、どの時間帯の時刻で数えるのかです。サーバーと決済代行サービスで数え方が違うと、月末の申し込みで請求の月がずれるおそれがあります。

下の図は、請求額を2か所で決める作りと1か所で決める作りの違いです。

請求額の決め方の図。2か所で決める作りでは、画面で計算した合計を決済に頼む金額にする。自社に記録する金額は、サーバーで別に計算した合計にする。2つの金額は突き合わせない。1か所で決める作りでは、サーバーで1回計算した結果から決済に頼む金額・自社に記録する金額・領収書に出す金額を作る。

開発会社や担当のエンジニアには、次のように聞いてみてください。

  • 請求額はどこで計算していますか。
  • 画面から送られた金額を、そのまま使っていませんか。
  • 料金を変えるとき、何か所を直しますか。
  • 請求の月や日付は、どの時間帯の時刻で数えていますか。

確認2:途中で失敗したとき、請求と記録に何が残るか

支払いの手順を「成功・失敗・途中離脱」で表にする

お金を動かす依頼(与信・確定・返金・解約)と、自社の記録の保存と、通知メールの送信は、別々に失敗しえます。この順番が決まっていない、または失敗したときに何が残るかが決まっていない作りは、画面と記録と決済側の状態が食い違うおそれがあります。画面にエラーと出たのを見て利用者がやり直し、二重の申し込みになるおそれもあります。

追加する前に、支払いの手順を段階に分け、それぞれが成功・失敗・途中離脱(画面を閉じた、通信が切れた)のときに何が残るかを表にしておくと、穴が見つけやすくなります。

表1 支払いの手順の状態表(記入例)

段階成功したとき失敗したとき途中離脱のとき
与信決済側に与信が残る。次の段階へ決済側には何も残らない。画面にエラー決済側に与信が残ることがある。記録はない
注文の保存記録に注文が残る決済側に与信だけが残る。取り消す処理が要る(自社で埋める)
確定(自社で埋める)(自社で埋める)(自社で埋める)
通知メール(自社で埋める)(自社で埋める)(自社で埋める)

表を埋めていくと、「画面にはエラーと出たが、裏では保存が済んでいる」のように、画面と記録が食い違う場合も洗い出せます。

「記録を元に戻す」だけでは、外で済んだ請求や返金は戻らない

自社のデータベースの取り消し(処理の途中で失敗したときに、記録を元に戻す仕組み)は、自社の記録にしか効きません。決済側で済んだ確定や返金は、自社の記録を戻しても戻りません。

決済側で確定や返金をしたあとに、メールの送信など別の処理が失敗すると、自社の記録だけが元に戻る作りがあります。この場合、決済側は確定済みなのに、記録は確定前のまま、というずれが残るおそれがあります。外部への依頼のあとに別の処理が失敗したとき、何を元に戻し、何を残すのかを決めておきます。

下の図は、決済側で確定や返金をしたあとに別の処理が失敗した場合です。

記録を元に戻す範囲の図。1. 自社のデータベースで記録を更新する。2. 決済代行サービスで確定や返金をする。3. メールの送信など別の処理が失敗する。4. 自社の記録を元に戻す。取り消しが効くのは自社のデータベースだけで、記録は確定前のままになる。決済代行サービスの確定や返金は、済んだまま残る。

あわせて、失敗したときに押さえた与信や請求を取り消す処理があるかも確かめます。取り消せなかったものを後でまとめて拾う処理を用意する場合は、その処理が本番で実際に動く設定になっているかまで見ておきます。

お金を動かす依頼と記録の変更は、どちらを先にするか決めておく

取り消し、取り直し、解約のように、自社の記録と決済側の両方を変える操作では、どちらを先に変えるかで、途中で止まったときに残る状態が変わります。

図2 解約で、記録を先に変える場合と、決済側を先に変える場合

記録を先に変える決済側を先に変える
1つ目の処理自社の記録を「解約済み」にする決済側の契約を取り消す
2つ目の処理決済側の契約を取り消す自社の記録を「解約済み」にする
2つ目で止まったとき記録は解約済み、決済側は契約が続き、請求も続く決済側は解約済み、記録は契約中のまま
止まったことに気づく手がかり決済側の請求を見るまで分からないことがある利用者が使い続けられるので、気づきにくいことがある

順番の例は筆者の解釈です。どちらの順番にも、途中で止まったときに残るものがあります。実際の作り方は、使っている決済代行サービスの仕様と、自社の業務に合わせて決めてください。

どちらが正しいというより、途中で止まったら、どちらの状態を正しいものとして扱い、誰がどう直すのかまで決めておくことが大事だと考えています。

確認3:決済側で起きたことを、自社の記録にどう反映するか

完了画面が開かれたときだけ記録する作りの弱点

支払いの記録を「完了画面が開かれたとき」だけ行う作りも、診断で見つかりやすいパターンです。

支払いの失敗、返金、カード会社経由の取り消しは、利用者が画面を操作しなくても決済側で起きます。完了画面だけを頼りにすると、これらの出来事は自社の記録に届きません。利用者が支払いの直後に画面を閉じた場合や、通信が切れた場合は、支払いそのものが記録されないおそれもあります。

図3 記録に届く出来事の比較

出来事完了画面だけで記録する作り決済側の通知を受ける作り
完了画面まで進んだ支払い○○
画面を閉じた後に済んだ支払い×○
月々の支払いの失敗×○
返金×○
カード会社経由の取り消し×○

決済側からの通知(Webhook)を受け取り、処理する

多くの決済代行サービスは、決済側で起きた出来事を自社のサーバーへ知らせる仕組み(Webhookと呼ばれることが多い)を用意しています。通知の受け口を作るだけでなく、受け取った出来事ごとに、何を変えるかを決めます。契約を止めるのか、利用者に知らせるのか、担当者に知らせるのかです。

通知の受け口は、外から呼べる場所に置かれます。届いた通知が本当に決済代行サービスから来たものかを、決済代行サービスが用意している方法(署名など)で確かめてから記録を変えます。

黙って状態を書き換えない。例外のときは誰に知らせるか

想定外の状態を見つけたときに、誰にも知らせずに状態を書き換える処理は、気づくのを遅らせます。たとえば、決済側の状態を定期的に見直す処理が、想定していない状態を見つけたら黙って「キャンセル済み」に書き換える、という作りです。代金を受け取れていないことに、入金を照らし合わせるまで気づけないおそれがあります。

例外のときに誰に知らせるのか、連絡先を決めておきます。

確認4:やり直しても、二重にならないか

「送り直せば大丈夫」とは限らない

決済代行サービスへの依頼が、一時的な障害の応答で失敗したときに、自動で送り直す作りがあります。読み取りだけの依頼なら送り直しても問題になりにくいのですが、お金を動かす依頼を送り直すと、与信・確定・返金が二重になるおそれがあります。

お金を動かす依頼は、「同じ依頼だ」と決済側と自社の両方が分かる印(重複を防ぐための番号)とセットで扱います。決済代行サービスがこうした印に対応しているかは、公開されている資料で確かめておきます。

まとめて行う請求処理をやり直したとき、二重にならないか

月ごとの請求のように、まとめて行う処理が途中で止まることがあります。止まったところから再実行したときに、処理済みの分をもう一度作ってしまう作りだと、同じ月の請求が二重になるおそれがあります。

何度やり直しても同じ結果になる(二重に作らない)ように作り、やり直しの手順も書いておきます。

同じ申し込みが重なったとき

ボタンの連続操作や、別のタブからの操作で、同じ申し込みが重なることがあります。重なったときに二重に決済されないかを確かめます。

二重の保存を「一意の制約」(同じものを2回保存できないようにするデータベースの決まり)で止める作りは、できている状態の例です。

一部の入口だけ守られている状態に気づく

重複を止める仕組みが、ある入口にはあるのに、別の入口にはない、という状態は見落としやすいものです。たとえば、利用者の画面からの二重送信は止まるのに、管理画面からの操作や自動の処理からの重複は止まらない、という作りです。入口ごとに確かめます。

ポイントや在庫のように、お金の価値があるものを減らしたり出したりする処理も、同じ考え方で確かめられます。

表2 やり直しで二重になりやすい処理と、防ぎ方の例

処理やり直すきっかけ二重になると防ぎ方の例
与信・確定・返金の依頼障害の応答で自動で送り直す二重の与信、二重の返金重複を防ぐ番号を付けて送る
まとめて行う請求処理途中で止まった処理の再実行同じ月の二重請求処理済みかを確かめてから作る。一意の制約
申し込みの保存ボタンの連続操作、別のタブ二重決済一意の制約。送信中はボタンを押せなくする
ポイント・在庫を減らす同時の操作、やり直し残りがマイナスになる減らす前に記録を固定する

確認5:追加したあと、動いていないことに気づけるか

定期の請求処理が「動かなかった」ことに気づけるか

月ごとの請求などの定期処理が失敗しても再実行されない、動かなかったことに誰も気づけない、という作りもあります。この場合、利用者や取引先からの問い合わせで初めて分かるおそれがあります。

定期処理が動かなかったときに、誰に知らせが届くのか、再実行はどうするのかを、追加と同時に決めておきます。

自社の記録と決済側を突き合わせる仕組みは、追加と同時に作る

自社の記録と決済側の記録を定期的に突き合わせる仕組み(照合)は、決済を足すのと同時に作っておきたいものです。そのとき、どの状態の記録を、決済側のどの状態と比べるのかを決めます。見ている範囲が狭いと、食い違いがあっても見つかりません。

決済の鍵の置き場所

決済代行サービスを使うための鍵は、ソースコードに書かず、環境ごとに分けた置き場所から読み込みます。本番の鍵がソースコードに書かれていると、ソースコードを読める人なら誰でも本番の鍵を使えてしまい、漏れたときの被害も大きくなります。本番に試験用の鍵が入っていないかも、あわせて確かめます。

決済側に登録した利用者とカードの情報を、いつ消すか

支払いのために決済側へ登録した利用者やカードの情報を、用が済んでも消さずにいる作りもあります。持ち続ける情報が多いほど、漏れたときの影響は大きくなります。いつ消すのかを、追加する前に決めておきます。

確認結果の書き方の見本:根拠・未確認・直す時期

「確認しました」だけでは、あとで判断に使えない

ここまでの項目を確かめても、結果が「確認しました」「問題ありません」だけでは、あとで判断に使えません。何を見て確かめたのか、確かめられなかったことは何か、いつ直すのかまで書いておくと、発注する側は「どこまで任せてよいか」「何が残っているか」を判断できます。

結果は「要対応」「未確認」「問題なし」の3つで書き、「問題なし」にも、確かめた範囲と確かめていない点を書きます。

1項目をこう書く(架空の見本)

以下のカードは、確認結果の書き方を示すための架空の見本です。実在の診断結果ではありません。

見本1 要対応(架空の見本)

確認すること
決済側からの通知が、本当に決済代行サービスから来たものかを確かめているか
結果
要対応
どう確かめたか
コードと設定を読み、試験環境で、送り主を確かめる情報(署名)のない通知を送ると、記録が「支払済」に変わることを確かめた
確かめていないこと
本番の受け口の設定は見ていない。返金など、ほかの種類の通知では試していない
業務への影響
支払われていない注文が、外から送られた通知だけで「支払済」になるおそれがある
直す時期
すぐ(理由:受け口は外から誰でも呼べるため)

見本2 未確認(架空の見本)

確認すること
月末の深夜に申し込んだとき、どの月の請求になるか
結果
未確認(問題があった場合の影響:中)
どう確かめたか
コードを読み、請求の月を決める処理を確かめた
確かめていないこと
本番のサーバーがどの時間帯の時刻で日付を数えているか。決済代行サービス側の締め日の扱い
確かめる方法
試験環境で時刻を月末の深夜に合わせて申し込み、自社の記録と決済側の請求の月を見比べる
直す時期
近いうちに(理由:月末に申し込みがあれば、毎月起こりうるため)

見本3 問題なし(架空の見本)

確認すること
返金の操作を、決められた担当者だけができるか
結果
問題なし
どう確かめたか
コードを読み、返金の操作は返金の権限を持つ担当者だけが行えることを確かめた。試験環境で、権限のない担当者のアカウントでは返金できないことも確かめた
確かめていないこと
決済代行サービスの管理画面から直接行う返金は、このシステムの外にあるため見ていない。管理画面に入れる人の一覧は、依頼元で確かめる必要がある

「未確認」を隠さない書き方

「未確認」は「問題がない」という意味ではありません。確かめられなかった理由と、誰が、何を見れば確かめられるのかを書きます。見本2のように「確かめる方法」まで書いておくと、あとで社内や開発会社が引き取って確かめられます。

「問題なし」にも、確かめていない点を書きます。見本3では、システムの中の返金の操作は確かめていますが、決済代行サービスの管理画面からの返金は見ていません。ここを書かずに「問題なし」とだけ書くと、確かめた範囲が実際より広く伝わってしまいます。

直す時期の決め方

直す時期は「すぐ」「近いうちに」「計画して」のように区分し、理由を一言添えます。理由があると、ほかの作業との優先順位を決めるときに使えます。

決済を足す前の確認では、これを「追加前に決める」「追加と同時に作る」「追加後に計画して直す」と読み替えると使いやすいと考えています(この読み替えは筆者の整理です)。

ソースコードと設定を読んで確かめる診断の報告書の形も、この見本と同じく、根拠と確かめた範囲をつけて書いています。

決済機能を追加する前の確認表

ここまでの確認を、開発会社や担当のエンジニアに渡せる形の表にまとめます。

表3 追加前の確認表

確認すること開発会社に聞く質問確かめ方の例時期の目安(筆者の整理)
請求額の決め方どこで計算し、何か所に料金が書かれているか。日付はどの時間帯で数えるかコードと設定を読む。料金を変える手順を見る追加前に決める
失敗時に残るもの各段階が失敗したら何が残るか。記録と決済側のどちらを先に変えるか状態表(表1)を埋める追加前に決める
決済側の出来事の反映失敗・解約・返金をどう記録に反映するか。通知の送り主を確かめているか出来事ごとの処理を一覧にする追加と同時に作る
やり直しと二重処理送り直し・再実行で二重にならないか。入口ごとに止まるか重複を防ぐ番号と一意の制約を、入口ごとに確かめる追加と同時に作る
追加後の見張り動かなかったことに誰が気づくか知らせの宛先と再実行の設定を確かめる追加と同時に作る
鍵と登録情報鍵はどこに置くか。登録した情報をいつ消すか置き場所と、消す決まりを確かめる追加前に決める。消す仕組みは追加後に計画してもよい

この表は確かめる観点の例で、すべてを含むものではありません。結果は、項目ごとに「要対応」「未確認」「問題なし」と、その根拠を添えて書いてください。

すでに運用中で、食い違いが心配なとき

すでに決済を使っていて、自社の記録と決済側の記録が食い違っていないか不安な場合は、この記事の確認とは別に、食い違いをどこから、どの順番でたどるかを考える必要があります。この記事では、その手順は扱いません。まずは表1を今の作りで埋めてみて、途中で止まったときに何が残るかを把握するところから始めるのがよいと思います。

ソースコードと設定を読んで確かめる診断

外から攻撃を試す脆弱性診断や侵入テストとは、見るものが違う確かめ方があります。ソースコードと設定を読み、この記事で挙げたような請求と記録の食い違い、個人情報の持ち方、運用の穴まで確かめる方法です。外から試す診断と組み合わせると、見える範囲が広がります。

私が行っている診断でも、報告書には「要対応」のほか「未確認」「問題なし」も、確かめた範囲とあわせて書いています。報告書は確かめた範囲の内容をまとめたもので、安全を保証するものではありません。

よくある質問

決済代行サービスを使えば、注文の記録との食い違いは起きませんか?

決済代行サービスが引き受けるのは、多くの場合、カード情報の扱いや支払いそのものです。自社の記録と決済側の記録が食い違わないようにするのは、自社の作りの側に残ります。この記事の確認2〜4がその部分です。

決済機能を足す前に、開発会社に何を確認すればよいですか?

表3の「開発会社に聞く質問」から始めてください。答えを聞いたら、それぞれ「要対応」「未確認」「問題なし」と、その根拠を書き残しておくと、あとで判断に使えます。

「未確認」と書かれた項目は、どう扱えばよいですか?

問題がないという意味ではありません。誰が、何を見れば確かめられるかを書いてもらい、直す時期と同じように、いつ確かめるかを決めてください。

確認した結果は、どの程度くわしく残せばよいですか?

見本のカードのように、確認すること、結果、どう確かめたか、確かめていないこと、直す時期とその理由が書いてあれば、あとから読んだ人も判断に使えます。

すでに決済を使っていて、食い違いが心配な場合は?

まず表1を今の作りで埋め、途中で止まったときに何が残るかを把握してください。食い違いをたどる手順は、この記事では扱っていません。

脆弱性診断を受けていれば、この確認は不要ですか?

外から試す診断と、ソースコードと設定を読んで確かめる方法は、見るものが違います。どちらか一方で足りるとは言えません。目的に合わせて組み合わせてください。

まとめ

決済を足す前に、金額の持ち主、失敗したときに残るもの、決済側の出来事の受け方、やり直しの扱い、追加後の見張りを決めておくと、請求・注文・取消のつながりで起きる事故の芽を、起きる前に見つけやすくなります。

確かめた結果は、「確認しました」ではなく、根拠と確かめていないこと、直す時期をつけて残してください。表3を開発会社と一緒に埋めて、答えが分からない項目が残ったら、それがいちばん先に確かめたいところです。

自分たちのWebアプリも確かめたいときは、ソースコードと設定を読んで事故につながる点を調べます。結果は報告書とオンラインでお伝えし、直すところやその後の見守りまで続けて相談できます。

Webアプリの診断内容を見る
ブログ一覧へ戻る