Markdownをコピー
リンクタイプ Plus Pay-easy決済
概要
リンクタイプ Plusでは、Pay-easy（ペイジー）決済を利用できます。
- Pay-easy決済を利用する場合は、実行パラメータセットにPay-easy決済固有の必要項目を渡してください。
URLの生成方法は3通りです。- 管理画面で生成：新規取引作成画面にて必要項目を入力してください。
- APIで生成：API呼び出し時にパラメータを指定してください。
- パラメータ型URL生成：パラメータ付きURLの生成時にパラメータを指定してください。
- 決済完了後は遷移先URLにPay-easy決済の結果パラメータを返却します。
実行パラメータ仕様
Pay-easy決済固有の実行パラメータは以下の通りです。
| json key | 説明 | 必須 | 形式 | 加盟店デフォルト値※1の登録可否 | システム デフォルト値※2 |
|---|---|---|---|---|---|
payeasy | Pay-easy決済固有実行パラメータ（親要素） Pay-easy決済固有実行パラメータ | — | — | — | — |
payeasy.CustomerName | 氏名 お客様の氏名を指定できます。 リンクタイプ Plusの画面上で、お客様に入力頂くことも可能です。 | — | 全半角40バイト | — | (null) |
payeasy.CustomerKana | フリガナ お客様のフリガナを指定できます。 リンクタイプ Plusの画面上で、お客様に入力頂くことも可能です。 | — | 全半角40バイト | — | (null) |
payeasy.TelNo | 電話番号 お客様の電話番号を指定できます。 リンクタイプ Plusの画面上で、お客様に入力頂くことも可能です。 | — | 半角数字13桁 | — | (null) |
payeasy.PaymentTermDay | 支払期限日数 支払期限日数を指定できます。 詳細は「Pay-easy決済 支払期限について」をご覧ください。 | — | 半角数字2桁 | ✔ | 10 |
payeasy.PaymentExpiryDateTime | 支払期限 支払期限を日時指定できます。（yyyyMMddHHmm形式） 例：202308222359 省略時は、支払期限日数で処理されます。 支払期限日数と本パラメータどちらも設定した場合は本パラメータが優先されます。 支払期限を超過した取引のURLでは、決済選択/入力画面でPay-easy決済を選択できません。 詳細は「Pay-easy決済 支払期限について」をご覧ください。 | — | 半角数字12桁 固定 | — | (null) |
payeasy.MailAddress | 結果通知先メールアドレス 「Pay-easy決済お支払番号のお知らせ」メールを送信する場合は、お客様のメールアドレスを設定してください。 リンクタイプ Plusの画面上で、お客様に入力頂くことも可能です。 | — | 半角英数記号256桁 | — | (null) |
payeasy.MailAddressRequiredFlag | 結果通知先メールアドレス必須フラグ ONにすると、リンクタイプ Plusの画面上での結果通知先メールアドレスの入力が必須になります。 0：OFF（任意入力）1：ON（必須入力） | — | 半角数字1桁 | ✔ | 0 |
payeasy.ShopMailAddress | 加盟店結果通知先メールアドレス お客様へ「Pay-easy決済お支払番号のお知らせ」メールを送信する際に、同時に加盟店様にも送信する場合のメールアドレスを指定可能です（BCCに設定されます）。 省略時は、ショップ情報に設定されたメールアドレスで処理されます。 | — | 半角英数記号256桁 | ✔ | (null) |
payeasy.ReceiptsDisp11 | お問い合わせ先 | ✔ | 全半角42バイト | ✔ | (null) |
payeasy.ReceiptsDisp12 | お問い合わせ先電話番号 | ✔ | 半角数字12桁 | ✔ | (null) |
payeasy.ReceiptsDisp13 | お問い合わせ先受付時間 レシート画面に表示されます。 例）09:00-18:00 | ✔ | 半角数字記号11桁 | ✔ | (null) |
※1 加盟店デフォルト値：設定IDに紐づけて加盟店様ごとに設定されたデフォルト値。ショップ管理画面で設定してください。都度のパラメータ指定がない場合に適用されます。
※2 システムデフォルト値：システムで設定されているデフォルト値。都度のパラメータ指定および加盟店デフォルト値がない場合に適用されます。
結果パラメータ仕様
Pay-easy決済を選択した場合に返却される固有の結果パラメータは以下の通りです。
| パラメータ | 説明 | 形式 |
|---|---|---|
payeasy | Pay-easy決済固有部（親要素） Pay-easy決済固有の結果パラメータセットです。 | — |
payeasy.Status | 取引状態 取引の状態を示す以下の値が設定されます。 REQSUCCESS：要求成功（お客様に、お支払いに必要な情報を提供した状態）PAYSUCCESS：決済完了（お客様がお支払いを完了した状態）EXPIRED：期限切れ（お客様がお支払いされることなく、有効期限が切れてしまった状態）CANCEL：支払停止（決済した取引の支払いを停止した状態）ERROR：決済エラー（決済時にエラーが発生した状態） | — |
payeasy.TranID | トランザクションID 弊社が処理を行うごとに発行している処理番号が設定されます。 | 半角英数28桁 |
payeasy.TranDate | 決済日時 決済依頼を実施した日時が設定されます。 （yyyyMMddHHmmss形式） | 半角数字14桁 |
payeasy.CustID | お客様番号 お客様がお支払い時に使用する番号が設定されます。 テスト環境においては、「EC + 半角数字8桁」を返却します。 | 半角数字11桁 |
payeasy.BkCode | 収納機関番号 お客様がお支払い時に使用する番号が設定されます。 | 半角数字5桁 |
payeasy.ConfNo | 確認番号 お客様がお支払い時に使用する番号が設定されます。 | 半角数字20桁 |
payeasy.PaymentTerm | 支払期限日時 お客様の払込期限が設定されます。 （yyyyMMddHHmmss形式） | 半角数字14桁 |
payeasy.EncryptReceiptNo | 暗号化決済番号 金融機関選択画面を呼び出す際に使用する番号が設定されます。 | 半角数字128桁 |
payeasy.FinishDate | 決済完了日時 お客様が決済を行った日時が設定されます。 （yyyyMMddHHmmss形式） 払込が完了していない場合、nullが設定されます。 | 半角数字14桁 |
payeasy.ReceiptDate | 受付日時 受付日時が設定されます。 （yyyyMMddHHmmss形式） | 半角数字14桁 |
payeasy.PayeasyPaymentURL | 金融機関選択画面URL 金融機関選択画面に遷移するURLが設定されます。 | 半角英数256桁 |
画面遷移
Pay-easy決済を選択した場合の画面遷移は以下の通りです。
- 決済選択/入力画面：決済手段としてPay-easyを選択し、お客様情報を入力
- 決済確認画面：入力内容を確認
- レシート画面：支払い番号等を表示
ワンポイント
確認画面、レシート画面はスキップ可能です。
スキップする場合は、共通パラメータのConfirmSkipFlagおよびReceiptSkipFlagを設定してください。
画面構成
決済選択/入力画面
- 決済選択コンボボックスで「Pay-easy」をクリック
- 必要な情報を入力し「次へ」をクリック
ワンポイント
お客様情報（氏名、フリガナ、電話番号、メールアドレス）は事前に指定することも、画面上で入力することも可能です。
決済確認画面
決済入力画面でお客様が入力した内容が表示されます。
- 表示された内容を確認し「確定」をクリック
レシート画面
決済手続きが完了した際に表示されます。
