Confidential

システム設定マニュアル
LinkPoint追加パラメータ

2022/04/19 更新

株式会社ゼウス

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

修正履歴Confidential

項番

修正日

対象ページ

内容

1

2021/5/31

-新規作成

2

2022/03/03

P.4, P.5

P.4 No8、 P.5 No21、許容値内容追加記載

32022/04/19

P.4～P.8

パラメータ名の定義を「_」から「頭文字を大文字」修正

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

2追加送信パラメータについて

Confidential•

2021/10/12以降、クレジットカードの新認証方式（EMV 3-D Secure）の導入に伴い、追加パラメータの送信が可能となります。

•

これらのパラメータは全て任意送信となっており、これらのパラメータを送信せずとも新認証方式自体の利用は可能です。

•

これらのパラメータを送信することで、ユーザーがパスワードを入力することなく認証が完了する可能性を引き上げることができます。

•

ただし、ある項目を入力すると関連項目が必須となる場合があります。本マニュアルの該当項目に明記しておりますので、ご確認ください。

•

これらの追加項目は項目数が多いため、複数ページに分けて説明いたします。

•

当資料10P目以降にデータ送信例を記載しております。

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

3追加送信パラメータ（カード所有者情報） ①
取引を行うカード会員(ユーザー)の情報。 (cardHolderInfo)№-

パラメータ名cardHolderInfo意

ｻｲｽﾞ（byte）

味

カード所有者情報を括るタグ

-

許容値-

1

addrMatch

カード会員(ユーザー)の配送先住所とカード会員(ユーザー)
1の請求先住所が同じか否かを示します。

Y = 配送先住所が請求先住所と一致する
N = 配送先住所が請求先住所と一致しない

2

billAddrCity

カード会員(ユーザー)の請求先住所の都市。

半角英数字および全角文字

Max50

ISO 3166-1の3桁の国コード。例：日本(392) アメリカ(840)
中国（156）

3

billAddrCountry

カード会員(ユーザー)の請求先住所の国コード。

3
カード会員(ユーザー)の請求先住所の州または都道府県（bill_addr_state）が存在する場合は必須です。

Confidential

4billAddrLine1

カード会員(ユーザー)の請求先住所の街路住所またはそれとMax50同等の区域部分の1行目。

半角英数字および全角文字

5

billAddrLine2

カード会員(ユーザー)の請求先住所の街路住所またはそれとMax50同等の区域部分の2行目。

半角英数字および全角文字

6

billAddrLine3

カード会員(ユーザー)の請求先住所の街路住所またはそれとMax50同等の区域部分の3行目。

半角英数字および全角文字

7

billAddrPostCode

カード会員(ユーザー)の請求先住所のZIPコードまたはその他Max50の郵便番号。

ハイフン区切りの有り/無し いずれも許容8billAddrState

カード会員(ユーザー)の請求先住所の州または都道府県。 Max3(桁)このフィールドにはISO 3166-2で定義されたcountry
subdivision codeを設定していただく必要がございます。
https://www.iso.org/obp/ui/#iso:code:3166:JP
設定の際には、文頭のJAを除いた値をご利用ください。（例：東京→13、神奈川→14）9

cardholderName

カード会員(ユーザー)の名前。

半角英数字

10

email

カード会員(ユーザー)が入力した、または3DSecureリクエス
ターのファイルに保存されている、アカウントに関連付けられた Max254
電子メールアドレス。

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

2-45

システム設定マニュアル Secure API トークン発行

4追加送信パラメータ（カード所有者情報） ②№Confidential

パラメータ名意

ｻｲｽﾞ（byte）

味11

homePhone.cc

カード会員(ユーザー)の自宅の電話番号の国コード 3

12

homePhone.subscriber

カード会員(ユーザー)の自宅の電話番号

Max15

13

mobilePhone.cc

カード会員(ユーザー)の携帯電話番号の国コード

314

mobilePhone.subscriber

カード会員(ユーザー)の携帯電話番号

Max15

15

shipAddrCity

指定された出荷先住所の都市部。

Max50

16

shipAddrCountry

指定された出荷先住所の国コード。

3

17

shipAddrLine1

指定された出荷先住所の街路住所またはそれと同等
Max50の区域部分の1行目。

18

shipAddrLine2指定された出荷先住所の街路住所またはそれと同等
Max50の区域部分の2行目。

19

shipAddrLine3指定された出荷先住所の街路住所またはそれと同等
Max50の区域部分の3行目。

20

shipAddrPostCode指定された出荷先住所のZIPコードまたはその他の郵
Max16
便番号。

許容値

ISO 3166-1の3桁の国コード。例：日本(392) アメリカ
(840) 中国（156）

ISO 3166-1の3桁の国コード。例：日本(392) アメリカ
(840) 中国（156）

ISO 3166-1の3桁の国コード。例：日本(392) アメリカ
(840) 中国（156）21

shipAddrState

この購入に使用されているカードに関連付けられた出Max3(桁)荷先住所の州または都道府県。

このフィールドにはISO 3166-2で定義されたcountry
subdivision codeを設定していただく必要がございます。
https://www.iso.org/obp/ui/#iso:code:3166:JP
設定の際には、文頭のJPを除いた値をご利用ください。（例：東京→13、神奈川→14）

22

workPhone.cc

カード会員(ユーザー)の職場の電話番号の国コード3

ISO 3166-1の3桁の国コード。例：日本(392) アメリカ
(840) 中国（156）23

workPhone.subscriber

カード会員(ユーザー)の職場の電話番号

Max15

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

5追加送信パラメータ（アカウント情報） ①
取引を行うカード会員(ユーザー)のアカウント情報。
Webサイト上などでの購入の場合に設定可能です。(acctInfo)№

パラメータ名- acctInfo意

ｻｲｽﾞ（byte）

味アカウント情報を括るタグ

-

許容値-

1

chAccAgeInd

カード会員(ユーザー)が加盟店サイトのアカウントを保有している期間。201 = アカウントなし（ゲストチェックアウト）
02 = この取引中にアカウントが作成された
03 = 30日未満
04 = 30～60日
05 = 60日を超える期間

2

chAccChange

カード会員(ユーザー)の加盟店サイトのアカウントが最後に変更された日付。変更の内容には、請求先住所または出荷先住所の変更、 8新しい決済口座または新しいユーザーの追加が含まれます。

YYYYMMDD

3

chAccChangeInd

カード会員(ユーザー)の加盟店サイトのアカウント情報が最後に変更されてからの経過期間。変更の内容には、請求先住所または出荷
2先住所の変更、新しい決済口座または新しいユーザーの追加が含まれます。

01 = この取引中に変更された
02 = 30日未満
03 = 30～60日
04 = 60日を超える期間

4

chAccDate

カード会員(ユーザー)が加盟店サイトのアカウントを開設した日付。

8

YYYYMMDD

5

chAccPwChange

カード会員(ユーザー)の加盟店サイトのアカウントでパスワードが変更
8
されたか、アカウントがリセットされた日付。

YYYYMMDD

6

chAccPwChangeInd

カード会員(ユーザー)の加盟店サイトのアカウントでパスワードが変更されてから、またはアカウントがリセットされてからの経過期間を示しま 2
す。

01 = 変更なし
02 = この取引中に変更された
03 = 30日未満
04 = 30～60日
05 = 60日を超える期間

7

nbPurchaseAccount

過去6ヶ月間にこのカード会員(ユーザー)アカウントで購入が行われMax4た回数。

半角数値

8

paymentAccAge

カード会員(ユーザー)の加盟店サイトのアカウントに決済口座が登録8された日付。

YYYYMMDD

9

paymentAccInd

カード会員(ユーザー)の加盟店サイトのアカウントに決済口座が登録2されてからの経過期間を示します。

01 = アカウントなし（ゲストチェックアウト）
02 = この取引中
03 = 30日未満
04 = 30～60日
05 = 60日を超える期間

10

provisionAttemptsDay

過去24時間に行われたカード追加の試行回数。

半角数値

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

Max3

システム設定マニュアル Secure API トークン発行

6追加送信パラメータ（アカウント情報） ②№意

ｻｲｽﾞ（byte）

味許容値

shipAddressUsage

この取引で使用される出荷先住所が加盟店で最初に使用され8た日付。

YYYYMMDD

12

shipAddressUsageInd

この取引で使用される出荷先住所が加盟店で最初に使用され2た時期を示します。

01 = この取引
02 = 30日未満
03 = 30～60日04 = 60日を超える期間

13

shipNameIndicator

アカウントのカード会員(ユーザー)名がこの取引で使用される出荷先名と同じかどうかを示します。

01 = アカウント名と出荷先名が同じ
02 = アカウント名と出荷先名が異なる

14

suspiciousAccActivity

加盟店がカード会員(ユーザー)アカウントで不審な行動（過去2の不正行為を含む）を発見したかどうかを示します。

01 = 不審な行動は見られなかった
02 = 不審な行動が見られた

15

txnActivityDay

過去24時間にこのカード会員(ユーザー)アカウントで、すべての決済口座を利用して行われた加盟店との（成功したおよび中止さ Max3れた）取引の回数。

半角数値

16

txnActivityYear

前年にこのカード会員(ユーザー)アカウントで、すべての決済口座を利用して行われた加盟店との（成功したおよび中止された） Max3取引の回数。

半角数値

11

Confidential

パラメータ名Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

2

システム設定マニュアル Secure API トークン発行

7追加送信パラメータ（不正リスクレベル評価）
カード会員(ユーザー)と実行中の認証の両方に対する特定の認証の不正リスクレベルの加盟店による評価。
（merchantRiskIndicator）№Confidential

パラメータ名意

ｻｲｽﾞ（byte）

味- merchantRiskIndicator

不正リスクレベル評価を括るタグ

1

電子デリバリーの場合は、商品を納品したときの納品先
Max254
電子メールアドレス。

半角英数記号

商品納品時間枠を示します。

01 = 電子デリバリー
02 = 当日出荷
03 = 翌日出荷
04 = 2日目以降の出荷

deliveryEmailAddress

2

deliveryTimeframe

3

giftCardAmount4

giftCardCount

5

giftCardCurr

6

preOrderDate

7

preOrderPurchaseInd

8

reorderItemsInd

9

shipIndicator

-許容値

2

プリペイドカードまたはギフトカードの購入の場合は、プリペイドカードまたはギフトカードの総購入金額の小数点 Max15以上の値（たとえば123.45ドルは123になります）。
プリペイドカードまたはギフトカードの購入の場合は、購入Max2されたプリペイドカードまたはギフトカード / コードの総数。
プリペイドカードまたはギフトカードの場合は、ISO 4217で定義されている通貨コード。※一部該当しないコード 3もございます。
先行予約購入の場合は、商品の発売予定日。

8

カード会員(ユーザー)が将来発売またはリリースされる商2品を注文しているかどうかを示します。
カード会員(ユーザー)が以前購入した商品を再び注文2しているかどうかを示します。

選択されている取引の出荷方法を示します。

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

2-

半角数字
半角数字
数値3桁。
例：日本円（392）米ドル（840）人民元（156）
フォーマット：YYYYMMDD
01 = 販売されている商品
02 = 将来発売される商品
01 = 初めての注文
02 = 再注文
01 = カード会員(ユーザー)の請求先住所に出荷する
02 = 加盟店のファイルに保存されている別の確認済み住所に出荷する
03 = カード会員(ユーザー)の請求先住所と異なる住所に出荷する
04 = "店舗へ出荷" / 近所の店舗での受け取り（店舗の住所は出荷先住所フィールドに入力される）
05 = デジタル商品（オンラインサービス、電子ギフトカードおよび償還コードを含む）
06 = 出荷されない旅行およびイベントのチケット
07 = その他（たとえば、ゲーム、出荷されないデジタルサービス、電子メディアの購読料など）

システム設定マニュアル Secure API トークン発行

8追加送信パラメータ（その他のパラメータ）№

パラメータ名意

ｻｲｽﾞ（byte）

味

許容値

YYYYMMDD
1 recurringExpiry

Confidential

定期的な支払いにおいてこの日付以降は承認されなくなる日付。

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

8

EnrolReqのpayment.countが02～24（分割払い）のとき、利用可能です。

システム設定マニュアル Secure API トークン発行

9データ送信例（開始タグ）【 データ送信例 】<FORM METHOD="POST" ACTION="https://linkpt.cardservice.co.jp/cgi-bin/credit/order.cgi" TARGET="_top">

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

10データ送信例（従来のLinkPoint送信パラメータ）
このページの送信例は、LinkPointのシステム設定マニュアルをご覧ください【 データ送信例 】<INPUT TYPE="hidden" NAME="clientip" VALUE="**********"><INPUT TYPE="hidden" NAME="money" VALUE="10000"><INPUT TYPE="hidden" NAME="sendid" VALUE="TEST"><INPUT TYPE="hidden" NAME="sendpoint" VALUE="TEST123"><INPUT TYPE="hidden" NAME="telno" VALUE="0334989030"><INPUT TYPE="hidden" NAME="email" VALUE="*****@cardservice.co.jp"><INPUT TYPE="hidden" NAME="success_url" VALUE="http://www.cardservice.co.jp1/"><INPUT TYPE="hidden" NAME="success_str" VALUE="トップページへ1"><INPUT TYPE="hidden" NAME="failure_url" VALUE="http://www.cardservice.co.jp2/"><INPUT TYPE="hidden" NAME="failure_str" VALUE="トップページへ2">

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

11データ送信例（カード所有者情報）【 データ送信例 】<INPUT TYPE="hidden" NAME="cardHolderInfo_addrMatch" VALUE="Y"><INPUT TYPE="hidden" NAME="cardHolderInfo_billAddrCity" VALUE="Bill City Name"><INPUT TYPE="hidden" NAME="cardHolderInfo_billAddrCountry" VALUE="840"><INPUT TYPE="hidden" NAME="cardHolderInfo_billAddrLine1" VALUE="Bill Address Line 1"><INPUT TYPE="hidden" NAME="cardHolderInfo_billAddrLine2" VALUE="Bill Address Line 2"><INPUT TYPE="hidden" NAME="cardHolderInfo_billAddrLine3" VALUE="Bill Address Line 3"><INPUT TYPE="hidden" NAME="cardHolderInfo_billAddrPostCode" VALUE="Bill Post Code"><INPUT TYPE="hidden" NAME="cardHolderInfo_billAddrState" VALUE="CO"><INPUT TYPE="hidden" NAME="cardHolderInfo_cardholderName" VALUE="Cardholder Name"><INPUT TYPE="hidden" NAME="cardHolderInfo_email" VALUE="example@example.com"><INPUT TYPE="hidden" NAME="cardHolderInfo_homePhone_cc" VALUE="123"><INPUT TYPE="hidden" NAME="cardHolderInfo_homePhone_subscriber" VALUE="123456789"><INPUT TYPE="hidden" NAME="cardHolderInfo_mobilePhone_cc" VALUE="123"><INPUT TYPE="hidden" NAME="cardHolderInfo_mobilePhone_subscriber" VALUE="123456789"><INPUT TYPE="hidden" NAME="cardHolderInfo_shipAddrCity" VALUE="Ship City Name"><INPUT TYPE="hidden" NAME="cardHolderInfo_shipAddrCountry" VALUE="840"><INPUT TYPE="hidden" NAME="cardHolderInfo_shipAddrLine1" VALUE="Ship Address Line 1"><INPUT TYPE="hidden" NAME="cardHolderInfo_shipAddrLine2" VALUE="Ship Address Line 2"><INPUT TYPE="hidden" NAME="cardHolderInfo_shipAddrLine3" VALUE="Ship Address Line 3"><INPUT TYPE="hidden" NAME="cardHolderInfo_shipAddrPostCode" VALUE="Ship Post Code"><INPUT TYPE="hidden" NAME="cardHolderInfo_shipAddrState" VALUE="CO"><INPUT TYPE="hidden" NAME="cardHolderInfo_workPhone_cc" VALUE="123"><INPUT TYPE="hidden" NAME="cardHolderInfo_workPhone_subscriber" VALUE="123456789">

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

12データ送信例（アカウント情報）【 データ送信例 】<INPUT TYPE="hidden" NAME="acctInfo_chAccAgeInd" VALUE="03"><INPUT TYPE="hidden" NAME="acctInfo_chAccChange" VALUE="20160712"><INPUT TYPE="hidden" NAME="acctInfo_chAccChangeInd" VALUE="04"><INPUT TYPE="hidden" NAME="acctInfo_chAccDate" VALUE="20140328"><INPUT TYPE="hidden" NAME="acctInfo_chAccPwChange" VALUE="20170328"><INPUT TYPE="hidden" NAME="acctInfo_chAccPwChangeInd" VALUE="02"><INPUT TYPE="hidden" NAME="acctInfo_nbPurchaseAccount" VALUE="11"><INPUT TYPE="hidden" NAME="acctInfo_paymentAccAge" VALUE="20160917"><INPUT TYPE="hidden" NAME="acctInfo_paymentAccInd" VALUE="04"><INPUT TYPE="hidden" NAME="acctInfo_provisionAttemptsDay" VALUE="3"><INPUT TYPE="hidden" NAME="acctInfo_shipAddressUsage" VALUE="20160714"><INPUT TYPE="hidden" NAME="acctInfo_shipAddressUsageInd" VALUE="04"><INPUT TYPE="hidden" NAME="acctInfo_shipNameIndicator" VALUE="02"><INPUT TYPE="hidden" NAME="acctInfo_suspiciousAccActivity" VALUE="01"><INPUT TYPE="hidden" NAME="acctInfo_txnActivityDay" VALUE="1"><INPUT TYPE="hidden" NAME="acctInfo_txnActivityYear" VALUE="21">Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

13データ送信例（不正リスクレベル評価）【 データ送信例 】<INPUT TYPE="hidden" NAME="merchantRiskIndicator_deliveryEmailAddress" VALUE="deliver@email.com"><INPUT TYPE="hidden" NAME="merchantRiskIndicator_deliveryTimeframe" VALUE="01"><INPUT TYPE="hidden" NAME="merchantRiskIndicator_giftCardAmount" VALUE="337"><INPUT TYPE="hidden" NAME="merchantRiskIndicator_giftCardCount" VALUE="02"><INPUT TYPE="hidden" NAME="merchantRiskIndicator_giftCardCurr" VALUE="840"><INPUT TYPE="hidden" NAME="merchantRiskIndicator_preOrderDate" VALUE="20170519"><INPUT TYPE="hidden" NAME="merchantRiskIndicator_preOrderPurchaseInd" VALUE="02"><INPUT TYPE="hidden" NAME="merchantRiskIndicator_reorderItemsInd" VALUE="01"><INPUT TYPE="hidden" NAME="merchantRiskIndicator_shipIndicator" VALUE="02">

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

14データ送信例（その他のパラメータ）【 データ送信例 】<INPUT TYPE="hidden" NAME="recurringExpiry" VALUE="20180131">

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

15データ送信例（終了タグと送信ボタン）【 データ送信例 】<INPUT TYPE="submit" VALUE="クレジット決済ページへ"></FORM>

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル Secure API トークン発行

16