申込

消費者ブラウザから店舗側の完了画面へリダイレクトする時のクエリパラメータ

※申込のリクエストで、paymentConfirmType="1"（サーバー間通信）の場合はリダイレクトしません。

売上

取消

検索

• 「設定」欄の内容は以下の通りとなります。

  要求電文 ...

  必須項目：○　　任意項目：△　　設定不可：×　　その他条件付：※（条件は説明欄に記入）

  応答電文 ...

  必ず返戻：○　　該当取引存在時に返戻：△　　返戻なし：×　　その他条件付：※

• 複数指定は0～の添字を指定します。

  例）exparam.serviceTypeCd[0]=card&exparam.serviceTypeCd[1]=linepay

• ワイルドカードは値の一部と"*"を組み合わせて検索します。"*"のみの指定はできません。

  例）exparam.searchParameters.common.orderId=123*

• 通常の検索の他、マスタ情報取得が可能です。マスタ情報取得時のインターフェイスは後記します。

結果通知電文の概要

実装方法の詳細につきましては、弊社より提供しているサンプルプログラムをご参照ください。

機能概要

決済サーバーから店舗システムへ決済の結果通知を行います。
通知は、HTTPのPOSTを利用します。

※プロトコルはHTTP（Port：80）、HTTPS（Port：443）に対応しています。
処理の概要については「結果通知受信処理」をご参照ください。

HMACについて

POSTにてデータを通知するとき、リクエストヘッダーにHMACを設定します。
また、HMAC値は、リクエストボディから算出します。
アルゴリズムは「HmacSHA256」が設定されます。

結果通知受信処理結果について

決済サーバーからの通知に対して店舗側システムがHTTPステータスコード"200"を返戻した場合、受信処理が正常に終了したものと判断します。"200"以外のコードを返した場合は、受信失敗と判断し、一定期間、通知を繰り返します。

※ 返戻した場合、受信処理が正常に終了したものと判断します。

LINE Payの結果通知電文

LINE Payにおける結果通知電文の通知タイミングは、決済確認方式によって異なります。

【決済確認方式：ブラウザを介する通信 の場合】

LINE Pay側で決済申込みが成立したタイミング（決済サーバーからの要求が成功したタイミング）となります。この時点では、店舗側の完了画面URLへの遷移はまだ行われていません。
消費者が画面遷移の途中で離脱した場合や、通信環境の問題で画面遷移時にタイムアウトが発生した場合には、最終遷移先の完了画面URLまで到達しない場合がありますので、このような場合にも、決済サーバーからの通知を店舗側システムで受信して頂くことで、決済が成立したことを検知することができます。

【決済確認方式：サーバ間通信 の場合】

LINE Pay側で決済申込の結果が確定したタイミングとなります。「ブラウザを介する通信」とは異なり、申込みが成功した場合も失敗した場合も、通知します。

以下に、LINE Payの結果通知項目を示します。

売上およびキャンセルの要求可能期間

LINE Payにおける、売上およびキャンセルの要求可能期間を下表に示します。

• 売上確定は、オーソリが成立していても失敗する可能性があります。LINE Payでは必ず売上が成功した後に商品の発送やサービス提供を行うようにしてください。

決済確認方式：サーバ間通信の場合の検索結果について

決済確認方式：サーバ間通信の場合は、結果通知か検索結果により決済の『成功／失敗』を判断します。
検索結果で決済の成功／失敗を判定するには、取引IDで検索（Search）を実施し、検索結果の「successDetailTxnType」を確認します。

• successDetailTxnTypeがAuthまたはAuthCaptureとなっている場合は、決済成功です。
• successDetailTxnTypeがInitまたはQuitAuthの場合は、決済失敗です。

なお、決済後に売上確定や与信取消などの処理を実施している場合は、successDetailTxnTypeはPostAuthやVoidAuthになりますので、
「表 5 詳細コマンドタイプと詳細オーダー決済状態」を参考に判定してください。

※決済申し込み後、消費者がLINEアプリの操作を完了させるまでに、最大で20分間時間をかけることができますので、検索は申し込み20分後に実施してください。

appUrlSchemeの指定方法

スマートフォン向けのサイトまたは、スマートフォン上で動作する独自アプリケーションからLINE Payを利用する場合には、LINE Payアプリで決済を実行後に、ブラウザまたはアプリに戻るためのURLスキームの指定が必要です。申込電文（LinepayAuthorizeRequestDto）のappUrlSchemeに指定して下さい。
appUrlSchemeには、プレースホルダ"<url>"を埋めこんだ文字列を指定して下さい。決済サーバー側で、LINE Payアプリで決済後の遷移先のURL（決済サーバーのURL）を設定してLINE Payに連携します。URLの"https://"は省略されますのでご注意ください。

主要ブラウザのURLスキームと、独自アプリケーションの場合の指定方法の例を以下に示します。

ブラウザを起動する場合は、利用者からのアクセス時のuser-agentによって利用ブラウザを判別し、適切なURLスキームを設定してください。Androidの場合には、packageNameを設定してください。
独自アプリを起動する場合は、プレースホルダ<url>を取得し、アプリ内ブラウザを利用して<url>に遷移してください。遷移後は、決済サーバーにて決済の成否判定を行い、加盟店様が指定したURLに遷移します。また、独自アプリを起動する場合で、申込電文（LinepayAuthorizeRequestDto）のuseOrignalAppに"1"を設定した場合は、LINE Payアプリから起動された際のパラメータのプレースホルダ<url>にはURLエンコーディングされた文字列が設定されますので、URLデコードしてご利用ください。

（独自アプリ起動時のLINE Pay取引番号の連携について）
LINE PayアプリがURLスキームを使ってアプリを呼び出す際には、appUrlSchemeにLINE Pay取引番号が付与されます。
&transactionId=取引番号の形式で末尾に付与されます。
LINE Pay取引番号は、申込の応答電文（LinepayAuthorizeResponseDto.linepayOrderId）にて連携していますので、加盟店の独自アプリ側でチェックのために利用することができます。実際のURLスキームの例を以下に示します。

redirectAppURLの利用方法

加盟店独自のスマートフォンアプリから決済申込を実行後、LINEアプリに移動して決済を行う方法について説明します。
尚、各OSでの実装はバージョン等で異なることがありますので下記は実装例として参照してください。

Androidアプリの例

以下のサンプルコードでLINEアプリのインストール有無と使用可能なLINE Payのバージョンを確認できます。
LINEアプリがインストールされていて、使用可能なLINE Payのバージョンが確認できたら、LINE Pay決済画面へ移動します。

int linePaySupportedVersion = 230;
String paymentUrl = "..."; // ここに redirectAppURL を設定してください。
Context context = getActivity();
try {
	PackageManager pm = context.getPackageManager();
	PackageInfo packageInfo = pm.getPackageInfo("jp.naver.line.android", 0);
	int versionCode = packageInfo.versionCode;
	if (linePaySupportedVersion <= versionCode) {
		launchUri(paymentUrl);
	} else {
		confirmLineInstall(context);
	}
} catch (NameNotFoundException e) {
	confirmLineInstall(context);
}

private void confirmLineInstall(Context context) {
	new AlertDialog.Builder(context)
	.setTitle("LINE Pay")
	.setMessage(getString(R.String.linepay_confirm))
	.setCancelable(false)
	.setPositiveButton(getString(R.String.linepay_install), new
 DialogInterface.OnClickListener() {
		@Override
		public void onClick(DialogInterface dialog, int which) {
			launchUri("market://details?id=jp.naver.line.android");
		}
	})
	.setNegativeButton(getString(R.String.linepay_cancel), new
 DialogInterface.OnClickListener() {
		@Override
		public void onClick(DialogInterface dialog, int which) {
		}
	})
	.show();
}

private void launchUri(String uriString) {

File : res/values/Strings.xml


	...
	Supported by Android/iPhone LINE versions 4.8.0 or
higher.
	Get it now
	cancel

iPhoneアプリの例

以下のサンプルコードでLINEアプリのインストール有無を確認することができます。LINEアプリがインストールされていたら、LINE Pay決済画⾯へ移動します。

NSString* lineScheme = @"line://";
BOOL installed = [[UIApplication sharedApplication]
				canOpenURL:[NSURL URLWithString:lineScheme]];
if (installed) {
	UIAlertView *alert =
	[[UIAlertView alloc] initWithTitle:@"LINE Pay"
message:NSLocalizedString(@"linepay.confirm", nil)
						delegate:self cancelButtonTitle:NSLocalizedString(@"linepay.ok",
nil) otherButtonTitles:nil];
	alert.tag = 1;
	[alert show];
} else {
	UIAlertView *alert =
	[[UIAlertView alloc] initWithTitle:@"LINE Pay"
message:NSLocalizedString(@"linepay.confirm", nil)
						delegate:self
cancelButtonTitle:NSLocalizedString(@"linepay.cancel", nil)
						otherButtonTitles:NSLocalizedString(@"linepay.install", nil),
nil];
	alert.tag = 2;
	[alert show];
}

- (void)alertView:(UIAlertView*)alertView clickedButtonAtIndex:(NSInteger)buttonIndex {
	if (alertView.tag == 1 && buttonIndex == 0) {
		NSString *paymentUrl = ...; // ここに redirectAppURL を設定してください。
		[self launchUrl:paymentUrl];
	} else if (alertView.tag == 2 && buttonIndex == 1) {
		[self launchUrl:@"itms-
apps://itunes.apple.com/WebObjects/MZStore.woa/wa/viewSoftware?id=443904275&mt=8"];
	}
}

File : en.lproj/Localized.Strings

"linepay.confirm" = "Supported by Android/iPhone LINE versions 4.8.0 or higher.";
"linepay.ok" = "OK";
"linepay.cancel" = "Cancel";
"linepay.install" = "Get it now";

※iOS10以降のアプリ連動時の注意事項

加盟店独自のスマートフォンアプリからLINEアプリに移動して決済申込を行う際CustomURLSchemeを呼び出してLINEアプリに移動しますが、iOS10以降ではCustomURLSchemeを使ったアプリ呼び出しが制限されています。
その為、加盟店様が独自アプリを提供している場合、以下のガイドラインに従って実装する必要があります。
具体的な対応方法については、以下のいずれかを検討してください。

方法１．LSApplicationQueriesSchemesの管理リストにLINEを追加する

File : info.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
...
<dict>
    <key>LSApplicationQueriesSchemes</key>
    <array>
        <string>line</string>
    </array>
</dict>

方法２．UIWebViewDelegate実装（※方法１での対応が不可能な場合）

import UIKit

class ViewController: UIViewController {

    let webView = UIWebView.init()

    override func viewDidLoad() {
        super.viewDidLoad()
        webView.frame = self.view.frame

        // setup delegate
        webView.delegate = self

        self.view.addSubview(webView)

  // merchant develop code
    }

}

extension ViewController: UIWebViewDelegate {
    // httpあるいはhttpsではなく外部スキームの場合、無条件に実行するように設定
    func webView(_ webView: UIWebView, shouldStartLoadWith request: URLRequest, navigationType: UIWebViewNavigationType) -> Bool {
        if let url = request.url, url.scheme != "http" && url.scheme != "https" {
            UIApplication.shared.open(url, options: [:], completionHandler: nil)
            return false
        }

checkUseBrowserの利用方法

LINE Payシステムで決済申込時のブラウザを識別できない場合、決済申込のブラウザとは異なるブラウザ（OSのデフォルトブラウザ）で決済結果の画面に遷移することがあります。
このような画面遷移をした場合に、加盟店様サイトで決済が成立しないなどの問題が生じる際にcheckUseBrowserをご利用ください。ただし、消費者のスマートフォン操作（画面遷移）が、通常とは少し異なりますので実際の動作をご確認の上、ご利用をご検討下さい。

※この機能は、LinepayAuthorizeResponseDtoの「redirectWebUrl」をご利用の場合のみ適用されます。
「redirectAppUrl」をご利用の際には適用されませんので、ご注意ください。

以下に画面遷移の例を示します。

checkUseBrowserに"false"を設定した場合の遷移（checkUseBrowserが未設定の場合も同様）

checkUseBrowserに"true"を設定した場合の遷移

PCまたはスマートフォン（ブラウザ）での画面遷移

Authorizeコマンドの結果として返戻されたリダイレクトURL（LinepayAuthorizeResponseDto.redirectWebUrl）に消費者のブラウザを遷移させると、以下の疑似環境が表示されます。

LINEの認証画面のイメージが表示されますので、そのまま「ログイン」ボタンをクリックして次の画面に遷移します。
この画面は、スマートフォンの場合やoneTimeKeyを指定した場合は表示されません。

上記画面イメージの上半分には、PC（またはスマホ）のブラウザに表示される、待機画面を表示しています。

本番の決済では、この待機画面が表示された後にLINE Payアプリ（スマートフォン）を使って決済を行います。
疑似環境では画面の下半分にスマホ画面のイメージを表示していますので、ここで「購入」または「キャンセル」を選択することで、以降の遷移を確認できます。
paymentConfirmTypeが"0"（ブラウザを介する通信）の場合、加盟店の決済完了画面（成功時のURL）またはキャンセル時のURLに遷移させることができます。
paymentConfirmTypeが"1"（サーバ間通信）の場合、決済申込完了通知か、検索（Search）にて取引の状態を確認することができます。

加盟店のエラー画面への遷移は、「7-3決済申込・売上・取消コマンドのエラーをシミュレートする」を参照してください。

スマートフォン（加盟店アプリ）を利用した場合の画面遷移

Authorizeコマンドの結果として返戻されたURL（LinepayAuthorizeResponseDto.redirectAppUrl）に加盟店アプリから移動すると以下の疑似環境が表示されます。
実際の動作ではLINEアプリが起動しますが、疑似環境ではブラウザ上にLINEアプリのイメージが表示されます。