Markdownをコピー
リンクタイプ Plus d払い決済
概要
リンクタイプ Plusでは、d払いを利用できます。
- d払いを利用する場合は、実行パラメータセットにd払い固有の必要項目を渡してください。
URLの生成方法は3通りです。- 管理画面で生成：新規取引作成画面にて必要項目を入力してください。
- APIで生成：API呼び出し時にパラメータを指定してください。
- パラメータ型URL生成：パラメータ付きURLの生成時にパラメータを指定してください。
- 決済完了後は遷移先URLにd払いの結果パラメータを返却します。
実行パラメータ仕様
d払い決済固有の実行パラメータは以下の通りです。
| json key | 説明 | 必須 | 形式 | 加盟店デフォルト値※1の登録可否 | システム デフォルト値※2 |
|---|---|---|---|---|---|
docomo | d払い決済固有実行パラメータ（親要素） d払い決済の実行パラメータセットです。 | — | — | — | — |
docomo.JobCd | 処理区分AUTH：仮売上CAPTURE：即時売上 | — | — | ✔ | AUTH |
docomo.DocomoDisp1 | ドコモ表示項目1 spモードの場合のみ、以下のd払い画面に表示されます。 ・決済内容確認画面 ・利用明細 商品の詳細説明や、お客様へのメッセージなどに利用してください。改行が必要な場合は表示項目１、表示項目２に分けて設定してください。 設定できない文字は、全角文字についてで禁止している文字に加え ",.,',¥,/です。 | — | 全半角40バイト | ✔ | (null) |
docomo.DocomoDisp2 | ドコモ表示項目2 spモードの場合のみ、以下のd払い画面に表示されます。 ・決済内容確認画面 ・利用明細 商品の詳細説明や、お客様へのメッセージなどに利用してください。改行が必要な場合は表示項目１、表示項目２に分けて設定してください。 設定できない文字は、全角文字についてで禁止している文字に加え ",.,',¥,/です。 | — | 全半角40バイト | ✔ | (null) |
docomo.DispCompanyName | 会社名 ドコモセンターの決済ページ及び決済結果メール等の連絡先として使用する会社名です。 設定できない文字は、全角文字についてで禁止している文字に加え ",.,',¥,/です。※包括契約加盟店様のみ設定が可能です。 | — | 全半角32バイト | ✔ | (null) |
docomo.DispShopName | 利用店舗名※3 ドコモセンターの決済ページ及び決済結果メール等の連絡先として使用する店舗名です。 DispShopName～DispShopUrlのいずれも指定しない場合は、登録されているショップ名を使用します。 設定できない文字は、全角文字についてで禁止している文字に加え ",.,',¥,/です。 | — | 全半角32バイト | ✔ | (null) |
docomo.DispPhoneNumber | 連絡先電話番号※3, 4, 5 ドコモセンターの決済ページ及び決済結果メール等の連絡先として表示する電話番号です。 設定可能な文字は半角数字と半角ハイフンのみです。 | — | 半角数字13桁 | ✔ | (null) |
docomo.DispMailAddress | メールアドレス※3, 4, 5 ドコモセンターの決済ページ及び決済結果メール等の連絡先として表示するメールアドレスです。 設定可能な文字は半角英数字、 @(半角アットマーク)、.(半角ピリオド)、-(半角ハイフン)、_(半角アンダースコア)のみです。 | — | 半角英数記号96桁 | ✔ | (null) |
docomo.DispShopUrl | 連絡先URL※3, 4, 5 ドコモセンターの決済ページ及び決済結果メール等の連絡先として表示するURLです。 設定可能な文字は半角英数と ",',\以外の半角記号です。なお、 /(半角スラッシュ)は4バイトとしてカウントされます。 | — | 半角英数96桁 | ✔ | (null) |
※1 加盟店デフォルト値：設定IDに紐づけて加盟店様ごとに設定されたデフォルト値。ショップ管理画面で設定してください。都度のパラメータ指定がない場合に適用されます。
※2 システムデフォルト値：システムで設定されているデフォルト値。都度のパラメータ指定および加盟店デフォルト値がない場合に適用されます。
※3：docomoと直接契約している加盟店様は、DispCompanyName～DispShopUrlの指定は不要です。
※4：ネット包括契約加盟店様は、DispCompanyName～DispShopUrlの値は無視され、企業コード、店舗コードに紐づいた内容が利用画面や明細に表示されます。
※5：DispPhoneNumber～DispShopUrlの設定値の合計バイト数を96バイト以内にしてください。
結果パラメータ仕様
d払い固有の結果パラメータセットです。
| パラメータ | 説明 | 形式 |
|---|---|---|
docomo | d払い決済固有部（親要素） | 半角英数32桁 固定 |
docomo.Status | 取引状態 取引の状態を示す以下の値が設定されます。 AUTH：仮売上CAPTURE：即時売上PAYFAIL：決済失敗（決済がエラーとなり支払いに失敗してしまった状態）UNPROCESSED：未決済（決済が完了していない状態）AUTHPROCESS：認証処理中（ドコモにて決済が処理中の状態） | — |
docomo.DocomoSettlementCode | ドコモ決済番号 オーソリ処理が正常終了した時にドコモから振り出される番号が設定されます。 お客様がMy docomo画面で確認できます。 | 半角数字12桁 |
docomo.DocomoCancelAmount | キャンセル金額 キャンセル時の金額が設定されます。 | 半角数字6桁 |
docomo.DocomoCancelTax | キャンセル税送料 キャンセル時の税送料が設定されます。 | 半角数字6桁 |
docomo.DocomoIncreaseAmount | 増加金額 増額時の金額が設定されます。 | 半角数字6桁 |
docomo.DocomoIncreaseTax | 増加税送料 増額時の税送料が設定されます。 | 半角数字6桁 |
docomo.Trandate | 決済日時 決済依頼を実施した日時が設定されます。 （yyyyMMddHHmmss形式） | 半角数字14桁 |
画面遷移
d払いを選択した場合の画面遷移は以下の通りです。
- 決済選択/入力画面：決済手段としてd払いを選択
- 決済事業者画面（NTTドコモ）：d払いサイトにて決済手続き
- レシート画面：決済完了
ワンポイント
確認画面、レシート画面はスキップ可能です。
スキップする場合は、共通パラメータのConfirmSkipFlagおよびReceiptSkipFlagを設定してください。
画面構成
決済選択/入力画面
- 決済選択コンボボックスで「d払い」をクリック
- 「次へ」をクリック
決済事業者画面（NTTドコモ）
お客様はd払いサイトにて決済手続きを行います。
レシート画面
d払いサイトにて決済手続きが完了した際に表示されます。
