Markdownをコピー
リンクタイプ Plus ネット銀聯
概要
リンクタイプ Plusでは、ネット銀聯決済を利用できます。
- ネット銀聯決済を利用する場合は、実行パラメータセットにネット銀聯決済固有の必要項目を渡してください。
URLの生成方法は3通りです。- 管理画面で生成：新規取引作成画面にて必要項目を入力してください。
- APIで生成：API呼び出し時にパラメータを指定してください。
- パラメータ型URL生成：パラメータ付きURLの生成時にパラメータを指定してください。
- 決済完了後は遷移先URLにネット銀聯決済の結果パラメータを返却します。
注意
ネット銀聯の利用開始前に、必ずショップ管理画面で加盟店名称を設定してください。
設定していない場合は決済時にエラーになります。
設定方法は管理画面を使った運用を参照してください。
実行パラメータ仕様
ネット銀聯固有の実行パラメータは以下の通りです。
| json key | 説明 | 必須 | 形式 | 加盟店デフォルト値※1の登録可否 | システム デフォルト値※2 |
|---|---|---|---|---|---|
unionpay | ネット銀聯固有実行パラメータセット（親要素） ネット銀聯の実行パラメータセットです。 | — | — | — | — |
unionpay.JobCd | 処理区分 以下のいずれかを設定します。 AUTH：仮売上CAPTURE：即時売上※ネット銀聯決済では、仮売上（AUTH）が成功した場合でも、その後の通貨レート変動の影響により、実売上がエラーとなる場合があります。このため、即時売上（CAPTURE）の使用をお勧めします。 | ✔ | — | ✔ | CAPTURE |
unionpay.CommodityName | 商品名 商品の名前です。半角英数＋記号（マイナス、アンダースコア、ドット、半角スペース）のみ使用可能です。 | — | 半角英数255桁 | ✔ | (null) |
※1 加盟店デフォルト値：設定IDに紐づけて加盟店様ごとに設定されたデフォルト値。ショップ管理画面で設定してください。都度のパラメータ指定がない場合に適用されます。
※2 システムデフォルト値：システムで設定されているデフォルト値。都度のパラメータ指定および加盟店デフォルト値がない場合に適用されます。
結果パラメータ仕様
ネット銀聯を選択した場合に返却される固有の結果パラメータは以下の通りです。
| パラメータ | 説明 | 形式 |
|---|---|---|
unionpay | ネット銀聯固有部（親要素） ネット銀聯固有の結果パラメータセットです。 | — |
unionpay.Status | 取引状態 取引の状態を示す以下の値が設定されます。 AUTH：仮売上CAPTURE：即時売上PAYFAIL：決済失敗（決済がエラーとなり支払いに失敗してしまった状態） | — |
画面遷移
ネット銀聯決済を選択した場合の画面遷移は以下の通りです。
- 決済選択/入力画面：決済手段としてネット銀聯を選択
- 決済事業者画面（銀聯）：銀聯サイトにて決済手続き
- レシート画面：決済完了
ワンポイント
確認画面、レシート画面はスキップ可能です。
スキップする場合は、共通パラメータのConfirmSkipFlagおよびReceiptSkipFlagを設定してください。
画面構成
決済選択/入力画面
- 決済選択コンボボックスで「ネット銀聯」をクリック
- 「次へ」をクリック
決済事業者画面（ネット銀聯）
お客様はネット銀聯サイトにて決済手続きを行います。
レシート画面
ネット銀聯サイトにて決済手続きが完了した際に表示されます。
