Markdownをコピー
リンクタイプ Plus Excelファイルフォーマット仕様
リンクタイプ Plusで使用するExcelファイルのフォーマット仕様を説明します。
ファイル一覧
対象のExcelファイルの一覧は以下の通りです。
| No | 機能 | 説明 |
|---|---|---|
| 1 | 決済一括送信ファイル | 管理画面で決済一括送信を実施するためにアップロードするファイル |
| 2 | 決済一括送信結果ファイル | 管理画面で決済一括送信を実施した結果をダウンロードするファイル |
| 3 | カード編集一括送信ファイル | 管理画面でカード編集一括送信を実施するためにアップロードするファイル |
| 4 | カード編集一括送信結果ファイル | 管理画面でカード編集一括送信を実施した結果をダウンロードするファイル |
注意事項
決済一括送信・カード編集一括送信をExcelファイルにより行うにあたり、以下の注意事項を確認してください。
ファイルの準備
- アップロードには、必ず管理画面からダウンロードした一括送信用Excelファイルを使用してください。
- 管理画面で項目設定を変更した場合は、一括送信用Excelファイルを再ダウンロードしてください。
- 項目設定変更前の一括送信用Excelファイルは使用できなくなります。
- 利用可能な形式は xlsx（Excel 2007以降） のみです。
xls（Excel 2003まで）は使用不可xlsm（Excel 2007以降のマクロ付きファイル）は使用不可
シート・列の編集ルール
- アップロード対象は 1シート目 のデータのみです。
- 一括送信ファイル項目のシートは必ず1シート目に設定してください。
- 次の操作は行わないでください。正常に動作しない可能性があります。
- ヘッダ行（1行目）のセル値を空にする
※「セル」とは「ひとつひとつのマス目」のことを指します。 - 項目列を削除する
- 項目列の間に列を追加する
- ヘッダ行（1行目）のセル値を空にする
セル入力時の確認
- 表示形式の書式は 文字列 に設定してください。
- 文字列でない場合、値が変換され、意図しない値で登録されることがあります。
- 例：
00012→12 - 例：
123456789012345→1.23457E+14
- 例：
- 非表示のセルもアップロード対象です。
- 結合セルは、結合範囲の先頭セルのみ値ありとして扱われます。
データ範囲・サイズ
- 空白行が現れた時点までが処理対象です（途中の空白行以降は無視）。
ファイル内に空白行が含まれていないか確認してください。 - ファイルサイズ上限は 5MB です。
決済一括送信ファイル（アップロードファイル）
このExcelファイルは、複数の決済データをまとめて登録するときに使います。
まず、管理画面の「決済一括送信」で、取引ごとに使う項目を設定してください。
設定手順は管理画面を使った運用を参照してください。
設定する項目の意味を確認したい場合は、以下を参照してください。
- 共通の項目: 決済機能：共通パラメータ
- 決済手段ごとの項目: 「決済機能：決済手段別」の各ページ（例: クレジットカード）
このあとの章では、次の内容を説明します。
- 入力が必須の項目： 必須項目
- よくある設定パターン： ユースケース別設定例
ファイルフォーマット仕様
| No | 項目 | 説明 |
|---|---|---|
| 1 | ファイル形式 | Excelファイル（xlsx形式） |
| 2 | ヘッダ行 | あり |
必須項目
Excelファイルでの一括送信時、以下の項目は値の入力が必須です。
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| ショップID | 13 | 【半角文字】英数 | 弊社が発行する値を設定します。 |
| 設定ID | 16 | 【半角文字】英数 | 管理画面で登録したデフォルト実行パラメータセットの 設定IDを指定します。 |
| オーダーID | 27 | 【半角文字】英数 【半角記号】 | 取引を特定する識別子です。 半角英数字とハイフン( -)が使用可能です。 |
| 利用金額 | 10 | 【半角文字】数 | 決済で使用する金額です。 |
ユースケース別設定例
- 決済URL案内メールと購入ありがとうメールを利用する場合
- 決済URL案内SMSを利用する場合
- クレジットカード決済で決済後カード登録機能を利用する場合
- クレジットカード決済で3DS2.0認証必須パラメータを設定する場合
決済URL案内メールと購入ありがとうメールを利用する場合
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| 決済URL案内メール送信フラグ | 1 | 【半角文字】数 | お客様への決済URL案内メール送信有無を設定します。0 ： メール送信しない（デフォルト）1 ： メール送信する |
| 購入ありがとうメール送信フラグ | 1 | 【半角文字】数 | 購入ありがとうメール送信有無を設定します。0 ： メール送信しない（デフォルト）1 ： メール送信する |
| 送信先メールアドレス（TO） | 256 | 【半角文字】英数 【半角記号】 | お客様のメールアドレスを設定します。 ※URL案内メール送信フラグ、購入ありがとうメール送信フラグのいずれかに 1を設定した場合、必須です。 |
| 顧客名 | 40桁 | 【半角文字】英数 【半角記号】 【全角文字】英数 かカ漢 【全角記号】全て | お客様名を設定します。 ※URL案内メール送信フラグ、購入ありがとうメール送信フラグのいずれかに 1を設定した場合、必須です。 |
| テンプレートNo. | 1 | 【半角文字】数 | 管理画面でアップロードしたテンプレートファイルのNo.を指定します。 ※URL案内メール送信フラグ、購入ありがとうメール送信フラグのいずれかに 1を設定した場合、必須です。 |
ファイルイメージ
決済URL案内SMSを利用する場合
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| 決済URL案内SMS送信フラグ | 1 | 【半角文字】数 | お客様への決済URL案内SMS送信有無を設定します。0 ： SMS送信しない（デフォルト）1 ： SMS送信する |
| SMS配信先携帯電話番号 | 15 | 【半角文字】数 | SMS配信先の電話番号を設定します。 ※決済URL案内SMS送信フラグに 1を設定した場合、必須です。 |
| 顧客名 | 40桁 | 【半角文字】英数 【半角記号】 【全角文字】英数 かカ漢 【全角記号】全て | お客様名を設定します。 ※決済URL案内SMS送信フラグに 1を設定した場合、必須です。 |
| テンプレートＮｏ． | 1 | 【半角文字】数 | 管理画面でアップロードしたテンプレートファイルのNo.を指定します。 ※決済URL案内SMS送信フラグに 1を設定した場合、必須です。 |
補足
SMS送信は別途オプション契約が必要です。
ファイルイメージ
クレジットカード決済で決済後カード登録機能を利用する場合
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| クレジットカード_決済後カード登録時会員ID | 60 | 【半角文字】英数 【半角記号】 | 決済後カード登録を行う場合、カードを登録する会員IDを指定します。 |
ファイルイメージ
クレジットカード決済で3DS2.0認証必須パラメータを設定する場合
3DS2.0認証必須項目の詳細については、3DS2.0認証必須項目についてを参照してください。
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| クレジットカード（3DS2.0）_カード会員のメールアドレス | 254 | 【半角文字】英数 【半角記号】 | 3DS2.0認証に使用するお客様のメールアドレスを設定します。 2連続ドットなどのRFC違反の形式となっているメールアドレスの場合はエラーとなるため設定しないでください。 |
| クレジットカード（3DS2.0）_携帯電話の国コード | 3 | 【半角文字】数 | 3DS2.0認証に使用するお客様の携帯電話の「国コード」を設定します。 設定する国コードはITU E.164の1～3桁の数字です。 ISO3166-1ではありませんので注意してください。 例として日本の場合は「81」です。 プラス記号(+)はつけないでください。 未指定時は81(日本)として扱います。 |
| クレジットカード（3DS2.0）_携帯電話番号 | 15 | 【半角文字】数 | 3DS2.0認証に使用するお客様の携帯電話番号を設定します。 先頭一桁目のゼロは省略しても、入力しても構いません。 例として東京都の場合 「0312345678」 「312345678」 どちらの形式でも入力可能です。 |
| クレジットカード（3DS2.0）_自宅電話の国コード | 3 | 【半角文字】数 | 3DS2.0認証に使用するお客様の自宅電話の「国コード」を設定します。 設定する国コードはITU E.164の1～3桁の数字です。 ISO3166-1ではありませんので注意してください。 例として日本の場合は「81」です。 プラス記号(+)はつけないでください。 未指定時は81(日本)として扱います。 |
| クレジットカード（3DS2.0）_自宅電話番号 | 15 | 【半角文字】数 | 3DS2.0認証に使用するお客様の自宅電話番号を設定します。 先頭一桁目のゼロは省略しても、入力しても構いません。 例として東京都の場合 「0312345678」 「312345678」 どちらの形式でも入力可能です。 |
| クレジットカード（3DS2.0）_職場電話の国コード | 3 | 【半角文字】数 | 3DS2.0認証に使用するお客様の職場電話の「国コード」を設定します。 設定する国コードはITU E.164の1～3桁の数字です。 ISO3166-1ではありませんので注意してください。 例として日本の場合は「81」です。 プラス記号(+)はつけないでください。 未指定時は81(日本)として扱います。 |
| クレジットカード（3DS2.0）_職場電話番号 | 15 | 【半角文字】数 | 3DS2.0認証に使用するお客様の職場電話番号を設定します。 先頭一桁目のゼロは省略しても、入力しても構いません。 例として東京都の場合 「0312345678」 「312345678」 どちらの形式でも入力可能です。 |
ファイルイメージ
決済一括送信結果ファイル（ダウンロードファイル）
決済一括送信結果ファイルは、加盟店様がアップロードした決済一括送信ファイルの項目に加えて以下の項目を出力します。
| 項目名 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| 状態 | 10 | 【半角文字】英 | 処理結果FORMATOK：フォーマットOKFORMATNG：フォーマットNGURLOUTPUT：URL出力済みMAILSEND：メール送信済みFAIL：処理失敗 |
| 決済URL | 256 | 【半角文字】英数 | 決済URL |
| 処理日時 | 14 | 【半角文字】数 | 処理を行った日時 yyyyMMddhhmmss書式 |
| エラー詳細コード | 【半角文字】英数 | エラーが発生した場合、エラーの詳細内容を示すエラーコード |
ファイルイメージ
カード編集一括送信ファイル（アップロードファイル）
このExcelファイルは、複数のお客様のカード編集データをまとめて登録するときに使います。
まず、管理画面の「カード編集一括送信」で、取引ごとに使う項目を設定してください。
設定手順は管理画面を使った運用を参照してください。
設定する項目の意味を確認したい場合は、以下を参照してください。
このあとの章では、次の内容を説明します。
- 入力が必須の項目： 必須項目
- よくある設定パターン： ユースケース別設定例
ファイルフォーマット仕様
| No | 項目 | 説明 |
|---|---|---|
| 1 | ファイル形式 | Excelファイル（xlsx形式） |
| 2 | ヘッダ行 | あり |
必須項目
Excelファイルでの一括送信時、以下の項目は値の入力が必須です。
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| ショップID | 13 | 半角英数 | 当サービスが発行する値を設定します。 |
| 設定ID | 16 | 半角英数 | 管理画面で登録したデフォルト実行パラメータセットの設定IDを指定します。 |
| カード編集番号 | 27 | 【半角文字】英数 【半角記号】 | 取引を特定する識別子です。 半角英数字とハイフン(-)が使用可能です。 注意：カード編集機会毎に一意になる番号を指定してください。 |
| 会員ID | 60 | 【半角文字】英数 【半角記号】 | 新規会員登録、または更新を行う会員IDを指定します。 |
ユースケース別設定例
カード編集URL案内メールと登録完了メールを利用する場合
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| カード編集URL案内メール送信フラグ | 1 | 【半角文字】数 | お客様へのカード編集URLメール送信有無を設定します。0：メール送信しない（デフォルト）1：メール送信する |
| 登録完了メール送信フラグ | 1 | 【半角文字】数 | 登録完了メール送信有無を設定します。0：メール送信しない（デフォルト）1：メール送信する |
| 送信先メールアドレス（TO） | 256 | 【半角文字】英数 【半角記号】 | お客様のメールアドレスを設定します。 ※カード編集URL案内メール送信フラグ、登録完了メール送信フラグのいずれかに 1を設定した場合、必須です。 |
| 顧客名 | 40桁 | 【半角文字】英数 【半角記号】 【全角文字】英数 かカ漢 【全角記号】全て | お客様名を設定します。 ※カード編集URL案内メール送信フラグ、登録完了メール送信フラグのいずれかに 1を設定した場合、必須です。 |
| テンプレートＮｏ． | 1 | 【半角文字】数 | 管理画面でアップロードしたテンプレートファイルのNo.を指定します。 ※URL案内メール送信フラグ、登録完了メール送信フラグのいずれかに 1を設定した場合、必須です。 |
ファイルイメージ
カード編集URL案内SMSを利用する場合
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| カード編集URL案内SMS送信フラグ | 1 | 【半角文字】数 | お客様への決済URL案内SMS送信有無を設定します。0：SMS送信しない（デフォルト）1：SMS送信する |
| SMS配信先携帯電話番号 | 15 | 【半角文字】数 | SMS配信先の電話番号を設定します。 ※カード編集URL案内SMS送信フラグに 1を設定した場合、必須です。 |
| 顧客名 | 40桁 | 【半角文字】英数 【半角記号】 【全角文字】英数 かカ漢 【全角記号】全て | お客様名を設定します。 ※カード編集URL案内SMS送信フラグに 1を設定した場合、必須です。 |
| テンプレートＮｏ． | 1 | 【半角文字】数 | 管理画面でアップロードしたテンプレートファイルのNo.を指定します。 ※カード編集URL案内SMS送信フラグに 1を設定した場合、必須です。 |
補足
SMS送信は別途オプション契約が必要です。
ファイルイメージ
決済後カード登録を利用する場合
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| カード番号取得元決済手段 | 1 | 【半角文字】数 | カード番号取得元の決済手段を設定します。credit：クレジットカードdcc：多通貨クレジットカード決済（DCC） |
| カード番号取得元オーダーID | 15 | 【半角文字】数 | カード番号取得元のオーダーIDを設定します。 本パラメータを使用すると決済時に使用したカード番号が初期表示されます。 お客様の決済が正常終了している場合のみ使用可能です。 |
ファイルイメージ（メール送信用項目＋決済後カード登録用項目）
カード編集で3DS2.0認証必須パラメータを設定する場合
3DS2.0認証必須項目の詳細については、3DS2.0認証必須項目についてを参照してください。
| 項目 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| 3DS2.0設定_カード会員のメールアドレス | 254 | 【半角文字】英数 【半角記号】 | 3DS2.0認証に使用するお客様のメールアドレスを設定します。 2連続ドットなどのRFC違反の形式となっているメールアドレスの場合はエラーとなるため設定しないでください。 |
| 3DS2.0設定_自宅電話の国コード | 3 | 【半角文字】数 | 3DS2.0認証に使用するお客様の自宅電話の「国コード」を設定します。 設定する国コードはITU E.164の1～3桁の数字です。 ISO3166-1ではありませんので注意してください。 例として日本の場合は「81」です。 プラス記号(+)はつけないでください。 未指定時は81(日本)として扱います。 |
| 3DS2.0設定_自宅電話番号 | 15 | 【半角文字】数 | 3DS2.0認証に使用するお客様の自宅電話番号を設定します。 先頭一桁目のゼロは省略しても、入力しても構いません。 例として東京都の場合 「0312345678」 「312345678」 どちらの形式でも入力可能です。 |
| 3DS2.0設定_携帯電話の国コード | 3 | 【半角文字】数 | 3DS2.0認証に使用するお客様の携帯電話の「国コード」を設定します。 設定する国コードはITU E.164の1～3桁の数字です。 ISO3166-1ではありませんので注意してください。 例として日本の場合は「81」です。 プラス記号(+)はつけないでください。 未指定時は81(日本)として扱います。 |
| 3DS2.0設定_携帯電話番号 | 15 | 【半角文字】数 | 3DS2.0認証に使用するお客様の携帯電話番号を設定します。 先頭一桁目のゼロは省略しても、入力しても構いません。 例として東京都の場合 「0312345678」 「312345678」 どちらの形式でも入力可能です。 |
| 3DS2.0設定_職場電話の国コード | 3 | 【半角文字】数 | 3DS2.0認証に使用するお客様の職場電話の「国コード」を設定します。 設定する国コードはITU E.164の1～3桁の数字です。 ISO3166-1ではありませんので注意してください。 例として日本の場合は「81」です。 プラス記号(+)はつけないでください。 未指定時は81(日本)として扱います。 |
| 3DS2.0設定_職場電話番号 | 15 | 【半角文字】数 | 3DS2.0認証に使用するお客様の職場電話番号を設定します。 先頭一桁目のゼロは省略しても、入力しても構いません。 例として東京都の場合 「0312345678」 「312345678」 どちらの形式でも入力可能です。 |
ファイルイメージ
カード編集一括送信結果ファイル（ダウンロードファイル）
カード編集一括送信結果ファイルは、加盟店様がアップロードしたカード編集一括送信ファイルの項目に加えて以下の項目を出力します。
| 項目名 | 最大バイト数 | 使用文字 | 説明 |
|---|---|---|---|
| 加盟店様がアップロードした「カード編集一括送信ファイル」の項目 | ー | ー | ー |
| 状態 | 10 | 【半角文字】英 | 処理結果FORMATOK：フォーマットOKFORMATNG：フォーマットNGURLOUTPUT：URL出力済みMAILSEND：メール送信済みFAIL：処理失敗 |
| カード編集URL | 256 | 【半角文字】英数 | カード編集URL |
| 処理日時 | 14 | 【半角文字】数 | 処理を行った日時 yyyyMMddhhmmss書式 |
| エラー詳細コード | 【半角文字】英数 | エラーが発生した場合、エラーの詳細内容を示すエラーコード |
ファイルイメージ
