ユースケース
決済フロー図
オーソリ、3-D セキュア、売上確定、返金、Webhook を、プロダクト・エンジニアリング・経理・サポートの誰もが読めるフローとして描きます。
シナリオ
プロダクトチームが新しいチェックアウトを追加しています。決済ゲートウェイ経由のカードとウォレット決済、リスクの高い注文での 3-D セキュア、売上確定と返金のための非同期 Webhook、そして経理が突合する夜間の精算ファイル。
シーケンスのライフラインは誰が誰をどの順で呼ぶかを示し、BPMN とフローチャートのノードはステータスとお金が次にどこへ動くかを示します。セキュリティの視点も同じキャンバスに置けます。ブランド付き公開リンクを共有するか SVG/PNG を書き出します。Pro は埋め込みと透かしなし PDF/JPEG を追加します。
描くもの
決済フロー図
- Sequence のアクターとライフラインとしての顧客、チェックアウト、ゲートウェイ、銀行
- 3-D セキュア、リトライ、拒否のためのフラグメント
- 売上確定、返金、チャージバックの経路のための BPMN タスクとゲートウェイ
- 非同期のステータス更新のための Webhook とキューのノード
- トークン保管庫、ID プロバイダ、ポリシーのための Security ノード
- 経理が突合する精算ファイルのための Document ノード
Archboard を選ぶ理由
Archboard は、決済シーケンス、精算プロセス、セキュリティの視点が 1 枚のキャンバスと 1 つの共有リンクを共有するホスト型ダイアグラムワークスペースです。エンジニアリング、経理、サポートは、食い違う 3 枚のスライドではなく同じ絵を読みます。
このキャンバスのパック
シーケンス · BPMN · フローチャート · セキュリティ
すべての組み込みパックは Free で使えます（3 ダイアグラム、各ダイアグラム 15 ノード＋メモ・テキスト・ステッカー・マインドマップのトピック 150 件、ブランド付き公開共有、AI エージェントとのライブ編集）。Pro では無制限のダイアグラムとノード、チームメイトがライブ編集するためのシート、埋め込み、透かしなしの書き出しが加わります（$10/シート/月）。
範囲
Archboard は決済フローを文書化します。決済を処理したり、カードデータを保存したり、連携を実行したりはしません。決済専用の記号セットはまだありません。現在は シーケンス、BPMN、フローチャート、セキュリティのノードで描きます。本物のカード番号、鍵、シークレットはどのダイアグラムにも入れないでください。
セッションの流れ
Google または GitHub でサインインし、テンプレートか空白のキャンバスから始める
アクターをライフラインとして置き、正常系のオーソリを描く
3-D セキュア、リトライ、返金のフラグメントを足し、続いて非同期の Webhook を描く
レビュー用にライブリンクを共有し、ランブック用に SVG か PNG を書き出す
いちばん近いテンプレート
Auth Sequence
いちばん近いテンプレートは Auth Sequence のサンプルです。OAuth 型のやり取りのためのアクター、ライフライン、フラグメントがあります。ライフラインの名前を顧客、チェックアウト、ゲートウェイ、銀行に変えれば、メッセージの順序はそのまま使えます。
ワークスペースに編集可能なコピーを開きます。Archboard が初めてなら Google または GitHub でサインインしてください。すぐにコピーが開きます。
誰もが追える決済フロー
決済フローは、レビューで誰が誰をどの順で呼ぶのかを誰も言えないときに破綻します。チェックアウトのチームは箱を描き、ゲートウェイのドキュメントは別の順序を示し、経理チームは精算について 3 つ目の図を持っています。決済フロー図が役に立つのは、順序をページに示したときです。顧客、加盟店アプリ、決済ゲートウェイ、プロセッサー、カード発行銀行をライフラインとして並べ、オーソリ、3-D Secure、売上確定、返金をその間のメッセージとして描きます。新しいウォレットやリトライ規則など手順が変わったら、同じ図を更新します。
まず正常系を描きます。オーソリ要求、応答、売上確定です。次に、障害の原因になりがちな分岐をフラグメントで加えます。3-D Secure のチャレンジ、リトライ付きのソフトデクライン、冪等キーが必要なタイムアウト、部分返金などです。非同期のステータスもマップに載せましょう。Webhook やキューは決済が静かに失敗する場所なので、脚注ではなく一人前のノードとして描きます。精算と照合の流れは、同じキャンバスに BPMN またはフローチャートのプロセスとして置き、売上確定した決済が銀行口座のお金になるまでの手順を経理が確認できるようにします。
フロー図からレビュー、そしてランブックへ
決済の図は、人の手に渡ってこそ役に立ちます。セキュリティレビューの担当者にはブランド付きの公開リンクを共有し、インシデント対応のランブックには SVG か PNG で書き出し、フローを変更する前には毎回リビジョンのスナップショットを保存して、ひとつ前の形にワンクリックで戻れるようにします。トークンボールト、ID プロバイダー、ポリシーといったセキュリティの視点をシーケンスの隣に置けば、レビュー担当者はカードデータがどこでトークン化され、どのシステムがまったく触れないのかを確認できます。Pro では社内 Wiki 向けの埋め込みと、透かしなしの PDF・JPEG を追加できます。
Archboard はフローを文書化するツールで、決済の処理、カードデータの保持、連携のテストは行いません。多くのチームは PCI DSS の対象範囲を話し合う前にこのマップを描きますが、評価そのものは審査担当者が行います。決済専用の記号セットはまだなく、現在は シーケンス、BPMN、フローチャート、セキュリティのノードでカバーしています。Google または GitHub でサインインし、いちばん近いテンプレートから始めて、ライフラインの名前を自社のチェックアウトに合わせて変えてください。
公開例を開く
- Auth Sequenceアクター、ライフライン、フラグメント。顧客、チェックアウト、ゲートウェイ、銀行に名前を変えて使えます。
- Zero Trust PerimeterID プロバイダー、WAF、ファイアウォール、ボールト。決済フローの隣に置くセキュリティの視点です。
- Streaming Data PlatformWebhook や精算ファイルの背後にあるキュー、トピック、ストア。
よくある質問
決済フローはシーケンス図とフローチャートのどちらで描くべきですか？
1 つのキャンバスで両方を使います。顧客、加盟店、ゲートウェイ、銀行の間のメッセージの順序には シーケンスのライフラインを、誰が誰を呼ぶかよりも次に何が起きるかが問われる精算、返金、チャージバックには BPMN またはフローチャートのプロセスを使ってください。
決済専用の記号セットはありますか？
まだありません。現在、決済フローは シーケンス、BPMN、フローチャート、セキュリティのノードで描きます。いちばん近いテンプレートを開けば、数分で名前を変えられる OAuth 型のシーケンスが手に入ります。
図に本物のカードデータを入れてもいいですか？
いいえ。本物のカード番号、鍵、シークレットはどの図にも入れないでください。フローには運ぶものの種類、たとえばトークン化されたカード参照や決済ステータスをラベルとして付け、データそのものは書かないでください。