決済依頼EXE使い方

ShopServe 決済依頼EXE使い方

外部プログラムから起動して使用します。

・起動方法
　ReqPayment.exe serial_codes=注文管理番号[,注文管理番号...]

例）1件の決済依頼
　ReqPayment.exe serial_codes=98a01b

例）複数件の決済依頼
　ReqPayment.exe serial_codes=98a01b,98a01a

＊serial_codes はカンマ区切りで指定してください。
＊1件のみ依頼する場合も serial_codes を使用してください。
＊一度に指定できる注文管理番号は最大100件です。
＊同じ注文管理番号を複数指定することはできません。

・処理内容
ShopServe 管理系一括更新APIを呼び出し、指定された注文管理番号の決済依頼を行います。
1件のみ指定された場合も、管理系一括更新APIを使用します。

・標準出力
処理結果は標準出力に出力します。
項目区切りはタブ、データ区切りは改行です。
ヘッダ行は出力しません。

出力形式：
　注文管理番号<TAB>OK/NG<TAB>メッセージ<TAB>内容

正常処理例：
　98a01b	OK		
　98a01a	OK		

ShopServe側で決済依頼できなかった場合：
　98a01b	NG	Order can not capture payment.	決済方法または決済ステータスの状態により更新できない

内部エラーの場合：
　SYSTEM	NG		エラーメッセージ

＊OK/NG は「その注文に対する決済依頼APIの実行結果」を示します。
＊OK の場合、第3項目と第4項目は空です。
＊NG の場合、第3項目にはShopServe APIから返されたメッセージ、第4項目には日本語説明を出力します。
＊定義していないメッセージが返された場合、第4項目には第3項目と同じ内容を出力します。
　この場合、未定義メッセージの内容はログに出力します。

・終了コード
管理系一括更新APIの呼び出しに成功し、注文ごとの結果を標準出力に出力できた場合は ExitCode=0 です。
標準出力に NG の行が含まれる場合でも、処理全体が正常に完了していれば ExitCode=0 です。
DB接続エラー、API通信エラー、JSON解析エラーなど、注文ごとの結果を作成できない内部エラーが発生した場合は ExitCode=9 です。

・エラーについて
標準出力に行単位で返る主なNG例：

* リソースが見つからない (Resource not found.)
* 注文管理番号未設定 (serial_code empty.)
* 注文管理番号不正 (serial_code type invalid.)
* パラメータ不正 (Bad parameter.)
* 受注情報が受注台帳に存在しない (Order is not in progress.)
* 合計金額が0円 (The total amount is 0 Yen.)
* 決済方法または決済ステータスの状態により更新できない (Order can not capture payment.)

この場合、処理全体は正常に完了しているため ExitCode=0 です。

内部エラーとして扱う主な例：

* serial_codes 未指定
* serial_codes の指定件数が100件を超過
* serial_codes に重複がある
* common.config が存在しない
* DB接続エラー
* API認証情報の取得失敗
* API通信エラー
* JSON解析エラー

内部エラーの詳細はログ、および標準出力に出力しています。
ExitCode<>0 のとき StandardOutput.ReadToEnd から理由を取得できます。

・繰り返し利用について
複数件の決済依頼を行う場合は、可能な範囲で serial_codes にまとめて指定してください。
一度に最大100件まで依頼できます。