Markdownをコピー
URLの種類
URLの種類
リンクタイプ Plus URLにはパラメータ型とキー型の2種類があります。
どちらの種類でもお客様に提供する機能は同一ですが、生成方法や利用可能な機能が異なります。
| 種類 | 概要 | 生成方法 |
|---|---|---|
| パラメータ型 | 決済の実行パラメータがURLに含まれる | 加盟店様のシステムで生成 |
| キー型 | 決済画面を表示するキーがURLに含まれる | URL取得API または 管理画面で生成 |
パラメータ型の特徴
- APIを実行せずにURLを生成できます。
- 実行パラメータがURLに含まれるため、URLが長くなる傾向があります。
キー型の特徴
- 実行パラメータがURLに含まれないため、URLがパラメータ型に比べ短くなります。
- メール・SMS送信機能や本人認証機能が利用できます。
URLの種類による機能の違い
決済に関する機能
| 機能 | パラメータ型 | キー型 |
|---|---|---|
| URL発行API | ✖ 非対応 | ✔ 対応 |
| 本人認証 | ✖ 非対応 | ✔ 対応 |
通知機能（メール）
| 機能 | パラメータ型 | キー型 |
|---|---|---|
| 決済URL案内メール | ✖ 非対応 | ✔ 対応 |
| 決済完了通知メール | ✔ 対応 | ✔ 対応 |
| 入金手続き完了通知メール | ✔ 対応 | ✔ 対応 |
| 購入ありがとうメール | ✖ 非対応 | ✔ 対応 |
| 前日分決済完了メール | ✔ 対応 | ✔ 対応 |
| カード編集URL案内メール | ✖ 非対応 | ✔ 対応 |
| カード編集手続き完了通知メール | ✔ 対応 | ✔ 対応 |
| 登録完了メール | ✖ 非対応 | ✔ 対応 |
メールの詳細は通知（メール/SMS）を確認してください。
通知機能（SMS）
| 機能 | パラメータ型 | キー型 |
|---|---|---|
| 決済URL案内SMS | ✖ 非対応 | ✔ 対応 |
| カード編集URL案内SMS | ✖ 非対応 | ✔ 対応 |
SMSの詳細は通知（メール/SMS）を確認してください。
URLの構成
パラメータ型URLの構成
決済URL：
https://[ドメイン]/v1/plus/[ショップID]/checkout/[ハッシュ付き実行パラメータセット]
カード編集URL：
https://[ドメイン]/v1/plus/[ショップID]/member/[ハッシュ付き実行パラメータセット]
| 要素 | 説明 |
|---|---|
| プロトコル | https（httpは利用不可） |
| ドメイン | 本番環境：link.mul-pay.jpテスト環境： stg.link.mul-pay.jp |
| バージョン | v1固定 |
| 機能名 | plus固定 |
| ショップID | 加盟店様のショップID |
| 機能種別 | 決済：checkout / カード編集：member |
| ハッシュ付き実行パラメータセット | 実行パラメータのbase64文字列（URLSafe） |
生成手順の詳細はパラメータ型URL生成をご確認ください。
キー型URLの構成
決済URL：
https://[ドメイン]/v2/plus/[ショップID]/checkout/[キー]
カード編集URL：
https://[ドメイン]/v2/plus/[ショップID]/member/[キー]
| 要素 | 説明 |
|---|---|
| プロトコル | https（httpは利用不可） |
| ドメイン | 本番環境：link.mul-pay.jpテスト環境： stg.link.mul-pay.jp |
| バージョン | v2固定 |
| 機能名 | plus固定 |
| ショップID | 加盟店様のショップID |
| 機能種別 | 決済：checkout / カード編集：member |
| キー | URL取得APIまたは管理画面で発行される、取引を特定するためのキー |