Markdownをコピー
リンクタイプ Plus FamiPay決済
概要
リンクタイプ Plusでは、FamiPayを利用できます。
- FamiPayを利用する場合は、実行パラメータセットにFamiPay固有の必要項目を渡してください。
URLの生成方法は3通りです。- 管理画面で生成：新規取引作成画面にて必要項目を入力してください。
- APIで生成：API呼び出し時にパラメータを指定してください。
- パラメータ型URL生成：パラメータ付きURLの生成時にパラメータを指定してください。
- 決済完了後は遷移先URLにFamiPayの結果パラメータを返却します。
実行パラメータ仕様
FamiPay決済固有の実行パラメータは以下の通りです。
| json key | 説明 | 必須 | 形式 | 加盟店デフォルト値※1の登録可否 | システム デフォルト値※2 |
|---|---|---|---|---|---|
famipay | FamiPay決済固有実行パラメータ（親要素） FamiPay決済の実行パラメータセットです。 | — | — | — | — |
famipay.AuthToken | 認証連携トークン SSO連携をする場合に設定する認証用トークンです。 一部の加盟店様のみ使用します。 | — | 半角英数256桁 | — | (null) |
※1 加盟店デフォルト値：設定IDに紐づけて加盟店様ごとに設定されたデフォルト値。ショップ管理画面で設定してください。都度のパラメータ指定がない場合に適用されます。
※2 システムデフォルト値：システムで設定されているデフォルト値。都度のパラメータ指定および加盟店デフォルト値がない場合に適用されます。
結果パラメータ仕様
FamiPayを選択した場合に返却される固有の結果パラメータは以下の通りです。
| パラメータ | 説明 | 形式 |
|---|---|---|
famipay | FamiPay決済固有部（親要素） FamiPay決済固有の結果パラメータセットです。 | 半角英数32桁 固定 |
famipay.Status | 取引状態 取引の状態を示す以下の値が設定されます。 PAYSUCCESS：決済が正常に完了した状態PAYFAIL：決済失敗（決済がエラーとなり支払いに失敗してしまった状態。お客様による支払い中断や、システムトラブル等の何らかの原因でお支払いに失敗してしまった状態） | — |
famipay.UriageNO | 売上No FamiPayの取引を特定するための番号が設定されます。 | 半角数字12桁 |
famipay.TranDate | 決済日時 決済を行った日時が設定されます。 （yyyyMMddHHmmss形式） | 半角数字14桁 |
画面遷移
FamiPayを選択した場合の画面遷移は以下の通りです。
- 決済選択/入力画面：決済手段としてFamiPayを選択
- 決済事業者画面（ファミリーマート）：FamiPayサイトにて決済手続き
- レシート画面：決済完了
ワンポイント
確認画面、レシート画面はスキップ可能です。
スキップする場合は、共通パラメータのConfirmSkipFlagおよびReceiptSkipFlagを設定してください。
画面構成
決済選択/入力画面
- 決済選択コンボボックスで「FamiPay」をクリック
- 「次へ」をクリック
決済事業者画面（ファミリーマート）
お客様はFamiPayサイトにて決済手続きを行います。
レシート画面
FamiPayサイトにて決済手続きが完了した際に表示されます。
