決済は成功したのにサイトに反映されない理由は?
利用者は支払いを完了したと言っているのに、サイトでは未決済のままになっている場合、資金の紛失よりも、コールバックをシステムが正しく受信できていないことが多くあります。何度もチャネルを切り替えるより、次の順序で調べるほうが早く原因にたどり着けます。
1. コールバックURLが実際にリクエストを受信しているか
コールバックURLが、インターネットからアクセス可能なHTTPSまたは取り決めたプロトコルであり、ファイアウォール、CDNの検証、誤ったパスで遮断されていないことを確認します。ログには、受信した通知の原文、到達時刻、応答コードを残してください。
2. 署名検証と各項目の照合が通っているか
署名、加盟店注文番号、金額、決済状態を照合します。署名失敗、金額不一致、注文が存在しない場合は、自動で商品を提供せず、手動で確認します。
3. 重複通知を破棄していないか
初回の処理に失敗すると、上流事業者は再試行します。APIがエラーを返したり、最初に注文を例外扱いした後の通知を無視したりすると、注文の取りこぼしに見えることがあります。注文の成功処理は一度だけにしつつ、失敗後に届いた有効な成功通知では、注文を成功状態に更新できるようにしてください。
4. 注文照会でコールバックを補完する
コールバックだけが情報源ではありません。タイムアウトした未完了注文を能動的に照会し、その結果でローカル状態を更新し、照会記録を残します。処理後は、取り決めた成功応答を返し、不要な再試行を防いでください。