Markdownをコピー
リンクタイプ Plus クレジットカード決済
概要
リンクタイプ Plusでは、クレジットカード決済を利用できます。
- クレジットカード決済を利用する場合は、実行パラメータセットにクレジットカード決済固有の必要項目を渡してください。
URLの生成方法は3通りです。- 管理画面で生成：新規取引作成画面にて必要項目を入力してください。
- APIで生成：API呼び出し時にパラメータを指定してください。
- パラメータ型URL生成：パラメータ付きURLの生成時にパラメータを指定してください。
- 実行パラメータセットに会員IDを指定すると、登録済みカード番号を表示し、そのまま決済に利用できます。
- 決済完了後は遷移先URLにクレジットカード決済の結果パラメータを返却します。
実行パラメータ仕様
クレジットカード決済固有パラメータ
クレジットカード決済固有の実行パラメータは以下の通りです。
| json key | 説明 | 必須 | 形式 | 加盟店デフォルト値※1の登録可否 | システム デフォルト値※2 |
|---|---|---|---|---|---|
credit | クレジットカード決済固有実行パラメータセット（親要素） クレジットカード決済の実行パラメータセットです。 | — | — | — | — |
credit.JobCd | 処理区分AUTH：仮売上CAPTURE：即時売上 | — | — | ✔ | AUTH |
credit.Method | 支払方法（単一指定）1：一括2：分割3：ボーナス一括5：リボ契約により利用可能な支払方法が異なります。利用可能な支払方法を選択してください。 | — | 半角数字1桁 | ✔ | — |
credit.Methods | 支払方法（複数指定） 以下の中から任意の支払方法を複数指定できます。 1：一括2：分割3：ボーナス一括5：リボ利用可能な支払方法を複数選択してください。例： ["1","2","3"]。MethodとMethodsを併用した場合はMethodsが適用されます。契約がない支払方法は画面に表示されません。 | — | 配列 | ✔ | — |
credit.PayTimes | 支払回数 分割払いの支払回数を1つに制限したい場合に設定します。 | — | 半角数字2桁 | ✔ | — |
credit.ItemCode | 商品コード 通常は省略してください。 | — | 半角英数7桁 | ✔ | 0000990 |
credit.TdFlag | 本人認証サービス利用フラグ 本人認証サービスの利用有無を指定します。 0：利用しない（3DSなしで決済）1：3DS1.0を利用する（サポート終了のため指定しないでください。指定時はショップ設定に従います）2：契約に従う（契約ありなら3DS実施契約なしなら非実施） 3：3DS2.0を利用する（契約なしの場合はエラー）本人認証を必須とする場合は必ず 3を指定してください。0を指定すると決済時にエラーになります。3DS2.0を未利用の間は0を指定してください。 | — | 半角数字1桁 | ✔ | 2 |
credit.TdTenantName | 3Dセキュア表示店舗名 3Dセキュア画面に表示する店舗名。EUC-JPでBASE64エンコードした値を指定してください。 空白のみ・改行は不可。省略時や不正なエンコード時はショップ名が表示されます。日本語利用時は文字化け有無を十分に確認してください。 | — | 半角英数記号25桁 | ✔ | — |
credit.MemberID | 会員ID 登録済みカード番号を表示して決済したい場合に指定します。 | — | 半角英数記号60桁 | ✖ | — |
credit.SecCodeRequiredFlag | セキュリティコード必須フラグ0：任意入力（OFF）1：必須入力（ON）ONにするとセキュリティコードの入力が必須になります。 | — | 半角数字1桁 | ✔ | 0 |
credit.SecCodeHiddenFlag | セキュリティコード非表示フラグ0：表示する（OFF）1：表示しない（ON）ONにするとセキュリティコード入力欄が非表示になります。 | — | 半角数字1桁 | ✔ | 0 |
credit.Tds2Type | 3DS2.0未対応時取り扱い 3DS2.0未対応カードの後続処理を指定します。 1：3DS1.0で認証（サポート終了。指定時はショップ設定に従います）2：エラーとして処理終了3：通常オーソリを実施3DS1.0サポート終了のため 1以外を指定してください。 | — | 半角数字1桁 | ✔ | 1 |
credit.RegistMemberID | 決済後カード登録時会員ID 決済後カード登録を行う場合に、カードを登録する会員IDを指定します。 指定し、お客様が登録を許可すると決済成功後にカード情報を登録します。会員が存在しない場合は会員登録も行います。削除済みIDやカードを5枚以上登録済みのIDは指定しないでください（登録に失敗します）。 | — | 半角英数記号60桁 | ✖ | — |
credit.RegistMemberForceFlag | 決済後強制カード登録フラグ0：お客様が選択（OFF）1：強制的に登録（ON）ONにすると決済成功後に必ずカード情報を登録します。本パラメータを使う場合は RegistMemberIDが必須です。会員が存在しない場合は会員登録も行います。削除済みIDやカードを5枚以上登録済みのIDは指定しないでください。 | — | 半角数字1桁 | ✔ | 0 |
credit.CardInputHiddenFlag | カード番号入力欄非表示フラグ0：表示する（OFF）1：表示しない（ON）ONかつ会員IDにカードが登録されている場合、カード入力欄を非表示にし登録済みカードのみ選択可能にします。 | — | 半角数字1桁 | ✔ | 0 |
credit.CardMaxCnt | 最大カード登録枚数（1～5） 決済後カード登録で1会員あたり登録できる最大枚数を指定します。 RegistMemberID指定時のみ有効です。カード編集機能と併用し両方で制御したい場合は双方で設定してください。 | — | 半角数字1桁 | ✔ | — |
※1 加盟店デフォルト値：設定IDに紐づけて加盟店様ごとに設定されたデフォルト値。ショップ管理画面で設定してください。都度のパラメータ指定がない場合に適用されます。
※2 システムデフォルト値：システムで設定されているデフォルト値。都度のパラメータ指定および加盟店デフォルト値がない場合に適用されます。
注意
- 削除済みの会員IDやカードを5枚以上登録している会員IDは
RegistMemberIDに指定しないでください。指定すると決済後カード登録に失敗します。 - 本人認証サービスを必須とする場合は、
TdFlagも「3DS2.0を利用する」に設定してください。
3DS2.0認証固有パラメータ（必須）
3DS2.0専用パラメータのうち、必須のパラメータは以下の通りです。
詳細は3DS2.0認証必須項目についてを参照してください。
| json key | 説明 | 必須 | 形式 | 加盟店デフォルト値※1の登録可否 | システム デフォルト値※2 |
|---|---|---|---|---|---|
credit.Tds2InputShowFlag | 3Dセキュア認証用入力欄表示フラグ0：OFF（表示しない）1：ON（表示する）ONにするとリンクタイプ Plus画面に3Dセキュア2.0認証用のメールアドレスと電話番号の入力欄を表示します。 ONの場合、画面上でお客様のメールアドレスか電話番号の入力が必須になります。以下のいずれかが指定されている場合は、ONにしても入力欄は表示されません： ・カード会員のメールアドレス ・自宅電話番号 ・携帯電話番号 ・職場電話番号 | — | 半角数字1桁 | ✔ | 0 |
credit.Tds2Email | カード会員のメールアドレス RFC違反の形式（例：2連続ドットなど）は設定しないでください。 「3Dセキュア認証用メールアドレス入力欄表示フラグ」をONにすると、画面でお客様入力も可能です。 | — | 半角英数記号254桁 | ✖ | (null) |
credit.Tds2HomePhoneCC | 自宅電話の国コード（ITU E.164の1～3桁の数字。ISO3166-1ではない点に注意） 例：日本は 81（プラス記号なし）未指定時は 81扱い | — | 半角数字3桁 | ✖ | (null) |
credit.Tds2HomePhoneSubscriber | 自宅電話番号 「3Dセキュア認証用メールアドレス入力欄表示フラグ」をONにすると、リンクタイプ Plus画面でお客様に入力いただくことも可能です。 先頭の 0は省略しても入力しても構いません例： 0312345678,312345678 | — | 半角数字15桁 | ✖ | (null) |
credit.Tds2MobilePhoneCC | 携帯電話の国コード（ITU E.164の1～3桁の数字。ISO3166-1ではない点に注意） 例：日本は 81（プラス記号なし）未指定時は 81扱い | — | 半角数字3桁 | ✖ | (null) |
credit.Tds2MobilePhoneSubscriber | 携帯電話番号 「3Dセキュア認証用メールアドレス入力欄表示フラグ」をONにすると、リンクタイプ Plus画面でお客様に入力いただくことも可能です。 先頭の 0は省略しても入力しても構いません例： 0312345678,312345678 | — | 半角数字15桁 | ✖ | (null) |
credit.Tds2WorkPhoneCC | 職場電話の国コード（ITU E.164の1～3桁の数字。ISO3166-1ではない点に注意） 例：日本は 81（プラス記号なし）未指定時は 81扱い | — | 半角数字3桁 | ✖ | (null) |
credit.Tds2WorkPhoneSubscriber | 職場電話番号 「3Dセキュア認証用メールアドレス入力欄表示フラグ」をONにすると、リンクタイプ Plus画面でお客様に入力いただくことも可能です。 先頭の 0は省略しても入力しても構いません例： 0312345678,312345678 | — | 半角数字15桁 | ✖ | (null) |
※1 加盟店デフォルト値：設定IDに紐づけて加盟店様ごとに設定されたデフォルト値。ショップ管理画面で設定してください。都度のパラメータ指定がない場合に適用されます。
※2 システムデフォルト値：システムで設定されているデフォルト値。都度のパラメータ指定および加盟店デフォルト値がない場合に適用されます。
3DS2.0認証必須項目
メールアドレスまたは電話番号（自宅/携帯/職場のいずれか）の指定が必須です。詳細は3DS2.0認証必須項目をご覧ください。
3DS2.0認証固有パラメータ（任意）
3DS2.0のリスク判定精度向上のため、以下の任意パラメータを設定することができます。
リンクタイプ PlusのURLをAPIで生成する場合にのみ設定可能です。
管理画面での生成やパラメータ型URL生成では設定できません。
| json key | 説明 | 必須 | 形式 | 加盟店デフォルト値※1の登録可否 | システム デフォルト値※2 |
|---|---|---|---|---|---|
credit.Tds2ChAccChange | カード会員最終更新日 YYYYMMDD形式で設定してください。 カード会員情報の最終更新日を設定します。 | — | 半角数字8桁固定 | ✖ | (null) |
credit.Tds2ChAccDate | カード会員作成日 YYYYMMDD形式で設定してください。 カード会員の作成日を設定します。 | — | 半角数字8桁固定 | ✖ | (null) |
credit.Tds2ChAccPwChange | カード会員パスワード変更日 YYYYMMDD形式で設定してください。 カード会員のパスワード変更日を設定します。 | — | 半角数字8桁固定 | ✖ | (null) |
credit.Tds2NbPurchaseAccount | 過去6ヶ月間の購入回数 過去6ヶ月間に、このカード会員が購入した回数を設定します。 | — | 半角数字4桁 | ✖ | (null) |
credit.Tds2PaymentAccAge | カード登録日 YYYYMMDD形式で設定してください。 カード会員にカード情報が登録された日付を設定します。 | — | 半角数字8桁固定 | ✖ | (null) |
credit.Tds2ProvisionAttemptsDay | 過去24時間のカード追加の試行回数 過去24時間に行われたカード情報追加の試行回数を設定します。 | — | 半角数字3桁 | ✖ | (null) |
credit.Tds2ShipAddressUsage | 配送先住所の初回使用日 YYYYMMDD形式で設定してください。 取引で使用される配送先住所が加盟店様で最初に使用された日付を設定します。 | — | 半角数字8桁固定 | ✖ | (null) |
credit.Tds2ShipNameInd | カード会員名と配送先名の一致/不一致01：カード会員名と配送先名が一致02：カード会員名と配送先名が不一致カード会員の会員名と取引に使用される配送先名の一致/不一致を設定します。 | — | — | ✖ | (null) |
credit.Tds2SuspiciousAccActivity | カード会員の不審行為情報01：不審な行動は見られなかった02：不審な行動が見られたカード会員で不審な行動（過去の不正行為を含む）を加盟店様が発見したかどうかを設定します。 | — | — | ✖ | (null) |
credit.Tds2TxnActivityDay | 過去24時間の取引回数 過去24時間に行われた、カード会員と加盟店様との取引の回数を設定します。 | — | 半角数字3桁 | ✖ | (null) |
credit.Tds2TxnActivityYear | 前年の取引回数 前年に行われた、カード会員と加盟店様との取引の回数を設定します。 | — | 半角数字3桁 | ✖ | (null) |
credit.Tds2DeliveryEmailAddress | 納品先電子メールアドレス 電子デリバリーの場合、商品を納品したときの納品先電子メールアドレスを設定します。 | — | 半角英数記号254桁 | ✖ | (null) |
credit.Tds2DeliveryTimeframe | 商品納品時間枠01：電子デリバリー02：当日出荷03：翌日出荷04：2日目以降の出荷商品納品時間枠を設定します。 | — | — | ✖ | (null) |
credit.Tds2GiftCardAmount | プリペイドカードまたはギフトカードの総購入金額 プリペイドカードまたはギフトカードを購入の場合、総購入金額の小数点以上の値を設定します。 | — | 半角数字15桁 | ✖ | (null) |
credit.Tds2GiftCardCount | 購入されたプリペイドカードまたはギフトカードの総数 プリペイドカードまたはギフトカードを購入の場合、購入された総数を設定します。 | — | 半角数字2桁 | ✖ | (null) |
credit.Tds2GiftCardCurr | 購入されたプリペイドカードまたはギフトカードの通貨コード プリペイドカードまたはギフトカードを購入の場合、カードの通貨を表す、ISO 4217で定義されている通貨コードを設定します。 以下のコードは対象外：955、956、957、958、959、960、961、962、963、964、999。 | — | 半角数字3桁固定 | ✖ | (null) |
credit.Tds2PreOrderDate | 商品の発売予定日 YYYYMMDD形式で設定してください。 先行予約購入の場合は、商品の発売予定日を設定します。 | — | 半角数字8桁固定 | ✖ | (null) |
credit.Tds2PreOrderPurchaseInd | 商品の販売時期情報01：発売済み商品02：先行予約商品先行予約購入か、発売済み商品の購入かを設定します。 | — | — | ✖ | (null) |
credit.Tds2ReorderItemsInd | 商品の注文情報01：初回注文02：再注文カード会員が以前購入した商品を再び注文しているかどうかを設定します。 | — | — | ✖ | (null) |
※1 加盟店デフォルト値：設定IDに紐づけて加盟店様ごとに設定されたデフォルト値。ショップ管理画面で設定してください。都度のパラメータ指定がない場合に適用されます。
※2 システムデフォルト値：システムで設定されているデフォルト値。都度のパラメータ指定および加盟店デフォルト値がない場合に適用されます。
結果パラメータ仕様
クレジットカード決済を選択した場合に返却される固有の結果パラメータは以下の通りです。
クレジットカード決済固有部
クレジットカード決済固有の結果パラメータセットです。
| パラメータ | 説明 | 形式 |
|---|---|---|
credit | クレジットカード決済固有部（親要素） | — |
credit.Status | 取引状態 取引の状態を示す以下の値が設定されます。 AUTH：仮売上CAPTURE：即時売上UNPROCESSED：未決済（オーソリエラー等で決済が完了していない状態）AUTHENTICATED：未決済（3DS登録済） | — |
credit.Forward | 仕向先コード 与信を行ったカード会社の会社コードが設定されます。 | 半角英数7桁 |
credit.Method | 支払方法 お客様が選択した支払方法が設定されます。 | 半角数字1桁 |
credit.PayTimes | 支払回数 お客様が選択した支払回数が設定されます。 | 半角数字2桁 |
credit.TranID | トランザクションID 弊社が処理を行うごとに発行している処理番号が設定されます。 | 半角英数28桁 |
credit.TranDate | 決済日時 与信を行った日時が設定されます。（yyyyMMddHHmmss形式） | 半角数字14桁固定 |
credit.Approve | 承認番号 カード会社が発行した与信の承認番号が設定されます。 | 半角英数7桁 |
決済後カード登録固有部
決済後カード登録固有の結果パラメータセットです。
決済後カード登録時会員IDが指定され、かつお客様がクレジットカード情報の登録を許可した場合、
クレジットカード決済固有部と共に加盟店様に返却されます。
| パラメータ | 説明 | 形式 |
|---|---|---|
registcard | 決済後カード登録固有部（親要素） | — |
registcard.SiteID | サイトID カードを登録した会員に紐付くサイトIDが設定されます。 | 半角英数13桁 |
registcard.MemberID | 会員ID 指定した決済後カード登録時会員IDが設定されます。 | 半角英数記号60桁 |
registcard.CardSeq | カード登録連番 登録したカードの論理連番が設定されます。 | 半角数字4桁 |
registcard.CardNo | カード番号 登録したカード番号をマスクした値が設定されます。 | 半角数字16桁 |
registcard.Result | 決済後カード登録処理結果 決済後カード登録の処理結果(状態)が設定されます。 SUCCESS：決済後カード登録に成功した状態FAIL：決済後カード登録に失敗した状態 | — |
画面遷移
クレジットカード決済を選択した場合の画面遷移は以下の通りです。
- 決済選択入力画面：決済手段を選択し、カード情報を入力
- 決済確認画面：入力内容を確認
- 3Dセキュア認証画面：カード発行会社による本人認証（本人認証サービス利用時のみ）
- レシート画面：決済完了
ワンポイント
確認画面、レシート画面はスキップ可能です。
スキップする場合は、共通パラメータのConfirmSkipFlagおよびReceiptSkipFlagを設定してください。
画面イメージ
会員IDの指定あり
実行パラメータに会員IDを指定すると、登録済みカードを選ぶか、新しくカード番号を入力できます。
決済選択/入力画面
- 決済選択コンボボックスで「クレジットカード」をクリック
2. 登録済みカード番号選択または新規カード番号入力を選択、必要な情報を入力し「次へ」をクリック
ワンポイント
- 初期状態では登録済みカード選択が有効で、コンボボックスから登録済みのカードを選択できます。
- 名義人を登録済みの場合は名義人欄に自動表示されます。
- 名義人保存にチェックして決済すると、登録済みカードに名義人を保存します。
決済確認画面
決済入力画面でお客様が入力した内容が表示されます。
- 表示された内容を確認し「確定」をクリック
ワンポイント
本人認証サービスをご利用の場合、確定クリック後に認証画面に遷移します。
注意
本人認証サービスを利用するには、対応したクレジットカードが必要です。
非対応のクレジットカードでは、設定を行っても本人認証サービスを利用できません。
レシート画面
決済手続きが完了した際に表示されます。
会員IDの指定なし
実行パラメータに会員IDを指定しない場合は、カード番号入力欄のみが表示されます。
決済選択/入力画面
- 決済選択コンボボックスで「クレジットカード」をクリック
2. 必要な情報を入力し「次へ」をクリック
決済確認画面
決済入力画面でお客様が入力した内容が表示されます。
- 表示された内容を確認し「確定」をクリック
ワンポイント
本人認証サービスをご利用の場合、確定クリック後に認証画面に遷移します。
注意
本人認証サービスを利用するには、対応したクレジットカードが必要です。
非対応のクレジットカードでは、設定を行っても本人認証サービスを利用できません。
レシート画面
決済手続きが完了した際に表示されます。
