素材サイトの決済導入で失敗を防ぐ:選定から公開までのチェックリスト
決済導入は「APIをつなぐだけ」に見えますが、本番稼働後の注文の取りこぼし、コールバックの欠落、照合の不一致、チャネルの突然の停止は、細かな部分に原因があることが多くあります。この記事では、よくある問題と確認事項をチェックリストにまとめ、チャネル選定、連携、テスト、本番公開時に確認できるようにしました。
1. まず、事業に必要なものを明確にする
チャネルを探す前に、次の点を確認してください。
- 利用者が主に使う決済方法は何か。AlipayとWeChat Payのどちらが多いか。
- 注文は少額で頻繁に発生するか、それとも時々高額の注文があるか。
- コールバック、署名検証、重複提供の防止に対応できる開発者がいるか。
- 許容できる手数料率と精算周期はどの程度か。
- 問題が起きたときの代替チャネルや緊急対応方法があるか。
2. チャネル選定で起こりやすい問題
1. 手数料率だけを見て、安定性やルールを確認しない
低い手数料率は魅力的ですが、利用可能時間、QRコードやチャネルの変更頻度、例外注文の処理方法、能動的な注文照会への対応も確認してください。
2. 口頭の約束と実際の機能が一致しない
本番公開前に、テスト環境または少量の注文で実際の決済を行い、コールバックの所要時間、失敗率、例外処理の方法を確認してください。
3. 連携前の準備チェックリスト
- 加盟店情報、精算口座、連絡先が正確で、必要な情報がそろっていることを確認する
- APIの秘密鍵や加盟店IDなどの機密情報を受け取り、安全に管理する(フロントエンドに平文で書かない)
- インターネットからアクセス可能なコールバックURLを用意する(HTTPSを推奨)
- 注文番号の生成ルールを決め、システム全体で一意になるようにする
- ローカル注文の状態管理を設計する(支払い待ち、決済済み、終了、例外など)
- ログ項目を決める:リクエストID、金額、状態、時刻、受信したコールバックの原文
4. 重複通知:特に問題が起こりやすい部分
決済成功後、チャネルは設定したURLへ通知を送ります。よくある問題は次のとおりです。
- コールバックを受信できない(ネットワーク、ファイアウォール、URLの誤り)
- 受信したが署名検証に失敗する
- 重複通知で商品提供や帳簿への記録が重複する
- 金額や注文番号が一致しないのに、誤って処理する
推奨する処理方法:
- まず署名を検証し、次に加盟店注文番号、金額、決済状態を照合する
- 注文番号ごとに処理結果を保存し、同じ成功注文は一度だけ処理する
- 処理成功後、チャネルが指定する成功応答を返す
- 重要な例外では通知の原文を保存し、能動的な注文照会で補完できるようにする
5. テストで必ず確認するシーン
- 通常の決済成功 → コールバック → ローカル状態の更新
- 利用者によるキャンセル・期限内に未決済
- 重複コールバック(同じ注文に複数回の通知)
- 金額の改ざんやローカル注文との不一致(拒否すべきケース)
- コールバックAPIが一時停止した後の再試行動作
- 少量の実利用者による検証(最初からすべての注文を流さない)
6. 本番公開日のチェックリスト
- 本番環境のパラメーターへ変更済みである(テスト用の秘密鍵が残っていない)
- コールバックURLがアクセス可能な本番環境を指している
- 監視やログで、成功・失敗のコールバックを確認できる
- 最初の注文の金額と状態を手動で照合する
- 精算口座と手数料率が取り決めどおりに有効であることを確認する
- 緊急時の連絡先を用意する(チャネル提供者と自社の技術担当)
7. 本番稼働後に継続して確認すること
- コールバック成功率と平均遅延
- 例外注文の割合と原因の内訳
- 件数・金額の照合が一致しているか
- 上流事業者からチャネル変更の通知があるか
- ピーク時に明らかな遅延や失敗が発生しているか
8. 問題を減らすための基本原則
- 事業の要件と対応能力を明確にしてから、チャネルを選ぶ
- 手数料率に加え、安定性やルールも重視する
- コールバックでは最初に署名を検証し、同じ注文は一度だけ処理して、ログを残す
- 成功例だけでなく、例外のシーンもテストする
- 少量で検証してから、利用規模を拡大する
- 法令への適合は基本条件。問題が起きたときの損失は、手数料率の差よりはるかに大きくなる
導入プランの評価中や、連携時のコールバック、照合、チャネル選定などでお困りの場合は、 お問い合わせページ から、事業の種類と現在の状況をお知らせください。できる限り具体的なアドバイスをご案内します。