決済CSVとは？入金確認・消込・システム連携で押さえたい基本

決済CSVとは

決済CSVとは、決済システムや決済代行会社などに保存されている取引データを、CSV形式で出力したファイルです。

一般的には、取引ごとに1行のデータが並び、

• 取引ID
• 顧客番号
• 請求番号
• 決済金額
• 決済日時
• 決済方法
• 決済結果

などの情報を列として持ちます。

CSVは表計算ソフトで開くだけでなく、会計システム、基幹システム、顧客管理システムなどへデータを取り込むためにも利用されます。

そもそもCSVとは

CSVは「Comma-Separated Values」の略で、一般的には複数の項目をカンマで区切って記録するテキスト形式です。

たとえば、次のようなデータです。

取引ID,顧客番号,決済金額,決済結果
TX000001,C000123,10000,成功
TX000002,C000124,5000,失敗

CSVは構造が比較的シンプルで、多くのシステムや表計算ソフトで扱えるため、データ交換に広く利用されています。

一方で、「CSVであれば、どのシステムでも同じ形式」というわけではありません。

どの列に何を入れるか、列名、列順、日付形式、文字コードなどは、システムごとに異なります。

決済CSVは何に使う？

決済CSVは、さまざまな業務で利用できます。

決済実績を確認する

まず基本となるのが、決済実績の確認です。

期間を指定してCSVを出力し、

• 何件決済されたか
• いくら決済されたか
• どの支払い方法が利用されたか
• どの取引が失敗したか

などを確認できます。

請求と決済を消し込む

実務では、決済結果そのものよりも「どの請求に対する決済か」が重要です。

たとえば、顧客Aに10,000円を請求し、10,000円の決済が成功している場合でも、金額が一致しているだけで同じ取引とは判断できません。

請求番号や取引IDなど、一意に識別できる情報を使って紐づける必要があります。

会計・基幹システムへ取り込む

決済CSVを、会計システムや基幹システムへ取り込む運用もあります。

決済システム側では決済に必要な情報を管理し、社内システム側では売上、顧客、会計処理などを管理する場合、CSVが両システムをつなぐデータ連携手段になります。

決済CSVで特に重要なのは「管理番号」

決済CSVを業務で活用するとき、特に重要になるのが管理番号です。

たとえば、次のような番号があります。

• 顧客番号
• 請求番号
• 申込番号
• 注文番号
• 取引ID
• 会員番号
• 学籍番号

どの番号を使うかは業務によって異なります。

重要なのは、決済システムと連携先システムの双方で同じ値を持ち、同じ取引を特定できることです。

決済CSVに持たせたい代表的な項目

必要な項目は業務によって異なりますが、代表的なものを整理すると次のようになります。

すべての情報を一つのCSVへ詰め込む必要はありません。

むしろ、誰が何の目的で使うCSVなのかを決めたうえで、必要な項目を選ぶことが重要です。

CSV設計で注意したいポイント

列順を安易に変更しない

CSVを人がExcelで確認するだけであれば、列順が変わっても大きな問題にならない場合があります。

しかし、他システムが「1列目は取引ID、2列目は顧客番号」のように固定位置で読み込んでいる場合、列を追加・移動すると連携が壊れる可能性があります。

システム連携用CSVでは、列の追加や変更をどのように扱うか、あらかじめルールを決めておくことが重要です。

先頭ゼロが消えないようにする

「001234」のような管理番号を表計算ソフトで開くと、数値として解釈され「1234」と表示される場合があります。

コードとして先頭ゼロに意味がある場合、文字列として扱う必要があります。

日付・日時の形式を統一する

日付には、

• 2026/09/28
• 2026-09-28
• 20260928

など複数の表現があります。

日時まで含める場合には、時刻やタイムゾーンをどう表現するかも決める必要があります。

システム間連携では、受け渡す形式を固定しておくことが重要です。

文字コードを確認する

CSVでは、日本語を含む場合に文字コードの違いによって文字化けが発生することがあります。

システム間連携では、UTF-8など、出力側と取込側で同じ文字コードを使えるように仕様を合わせます。

カンマや改行を含む文字列を考慮する

会社名、住所、備考欄などの自由入力データには、カンマ、引用符、改行が含まれる可能性があります。

CSVでは、こうした文字を含むフィールドを適切に引用・エスケープする必要があります。

「人が見るCSV」と「システム連携CSV」は分けて考える

一つのCSVですべての用途を満たそうとすると、設計が複雑になることがあります。

たとえば、経理担当者がExcelで確認したいCSVでは、

• 日本語の分かりやすい列名
• 氏名
• 商品名
• 決済ステータス

などがあると便利です。

一方、システム連携用CSVでは、

• 列順を固定する
• コード値を使用する
• 不要な自由記述を減らす
• データ型や桁数を仕様化する

ことが重要になります。

決済CSVから消込する基本的な流れ

決済CSVを使った消込の基本的な流れを整理すると、次のようになります。

CSV出力ではセキュリティにも注意する

決済CSVには、顧客情報や取引情報など、業務上重要なデータが含まれることがあります。

そのため、ダウンロード権限、操作ログ、保存場所、社内での共有方法などを適切に管理する必要があります。

また、自由入力項目など、外部から入力された文字列をそのままCSVへ出力する場合には、別の注意点もあります。

CSVインジェクションとは

表計算ソフトでは、セルの先頭が「=」など特定の文字で始まる場合、値ではなく数式として解釈されることがあります。

Webフォームなどで入力された値をそのままCSVへ出力し、そのファイルをExcel等で開いた場合、意図しない数式として処理される可能性があります。

これはCSVインジェクション、またはFormula Injectionと呼ばれる問題です。

CSVとAPIはどちらを使う？

システム連携を考えるとき、CSVとAPIのどちらがよいかという質問もあります。

どちらかが常に優れているわけではありません。

たとえば月1回の会計連携であればCSVで十分なこともあります。

一方、決済結果をすぐサービス提供へ反映したい場合には、API連携の方が適していることがあります。

現在の業務量、更新頻度、連携先システム、開発コストなどから選ぶことが重要です。

決済CSVを設計するときの確認ポイント

まとめ：CSVは決済データを業務につなぐインターフェース

決済CSVは、決済履歴を一覧で確認するためだけのファイルではありません。

請求番号や顧客番号などを適切に持たせることで、請求と決済の消込、未収管理、会計処理、基幹システムとの連携などに活用できます。

一方、CSVはシンプルな形式であるからこそ、列順、文字コード、日付形式、先頭ゼロ、自由入力値など、細かな仕様の違いが連携エラーにつながることがあります。

大切なのは、「CSVを出せるか」ではなく、そのCSVによって、どの業務とどの業務をつなぐのかを明確にすることです。

決済CSVを、単なるダウンロード機能ではなく、請求・決済・入金・会計をつなぐインターフェースとして設計していきましょう。