メインコンテンツまでスキップ

クイックリンクペイスキーム統合ガイド

クイックリンクペイとは​

クイックリンクペイは、ニューエイジが加盟店向けに提供するモバイル端末APPで、加盟店はクイックリンクペイを使ってコードスイープ取引、請求照会、取引集計などを行うことができる。クイックリンクペイはまた、スキームコールを提供し、他のAPPがリンクペイの決済機能を呼び出すことができます。LinkPay APPはAPP StoreとGoogle Playからダウンロードできます。

スキームとは​

Schemeは、アプリケーション内の異なるページや関数間のジャンプを定義する方法です。Schemeを使えば、アプリケーション内の異なるページ間を素早くジャンプしたり、他のアプリケーションやウェブページからアプリケーション内の特定のページにジャンプしたりできる。

統合プロセス​

アンドロイド統合プロセス​

  1. まず最初に、アプリファイルのAndroidManifest.xmlファイルにURL SchemesとIdentifierを設定して、linkpayトランザクションが完了した後にアプリのインターフェイスにジャンプバックできるようにする必要があります。このように：
<activity
            android:name=".MainActivity"
            android:exported="true"
            android:launchMode="singleTop"
            android:screenOrientation="portrait"
            android:theme="@style/Theme.AppCompat.Light.NoActionBar">
            <intent-filter>
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                  <data android:host="payment.com"
                        android:path="/result"
                        android:scheme="app" />
            </intent-filter>
        </activity>
  1. リンクペイを始めるには、このようにschemeを使う：

消費メッセージ:

Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("linkpay://newage.com/cashier?merchant_order_no=1122223&trans_type=1&order_amount=1&notify_url=app://payment.com/result"));
startActivity(intent);

返金メッセージ:

Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("linkpay://newage.com/cashier?merchant_order_no=1122223&orig_merchant_order_no=122222&trans_type=3&order_amount=1&notify_url=app://payment.com/result"));
startActivity(intent);

IOS統合プロセス​

  1. まず最初に、アプリファイルのinfo.plistファイルにURL SchemesとIdentifierを設定して、リンクペイのトランザクションが完了した後にアプリのインターフェイスにジャンプバックできるようにする必要があります。このように：
<key>CFBundleURLName</key>
			<string>payment.com/result</string>
			<key>CFBundleURLSchemes</key>
			<array>
				<string>app</string>
			</array>
  1. リンクペイを始めるには、このようにschemeを使う：

消費メッセージ:

 let url = URL(string: "linkpay://newage.com/cashier?merchant_order_no=1122223&trans_type=1&order_amount=1&notify_url=app://payment.com/result")!
                        if UIApplication.shared.canOpenURL(url) {
                            UIApplication.shared.open(url, options: [:], completionHandler: nil)
                        }

返金メッセージ:

let url = URL(string: "newage.com/cashier?merchant_order_no=1122223&orig_merchant_order_no=122222&trans_type=1&amount=1&notify_url=app://payment.com/result")!
if UIApplication.shared.canOpenURL(url) {
    UIApplication.shared.open(url, options: [:], completionHandler: nil)
}

取引メッセージ​

リクエストパラメータ​

名称IDタイプ必須説明
通知URLnotify_urlText(32)Mコールバックを開始するために、LinkPayトランザクションが完了したときに通知される必要があるスキームアドレス
支払いシーンpay_scenarioText(32)O支払いシーン, 見る PayScenario
Example：BSCANQR_PAY
支払い方法IDpay_method_idText(32)O支払い方法番号。支払い方法を指定する場合, 見る ペイメソッド
例：Alipay
注文金額order_amountAmountM引用通貨で表示,主に円をサポート
取引タイプtrans_typeNumberMトランザクション・タイプ, 見る トランスタイプ, 現在、消費と払い戻しのみがサポートされています
例：1
マーチャントシステム注文番号merchant_order_noText(32)M払い戻しは、払い戻しに適用される注文番号とし、元の消費取引の注文番号とは異なるものとする。
オリジナル加盟店システム注文番号orig_merchant_order_noText(32)Cトランザクション・タイプが払い戻しの場合、最大32文字の英数字を使用しなければならない trans_type == 3
例：1217752501201407033233368018
注文の説明情報descriptionText(32)C注文の説明情報

応答パラメーター​

名称IDタイプ必須説明
トランスノーtrans_noText(32)Mトランザクションが成功したときに返されるトランザクション・オーダー番号。
トランス・ステータスtrans_statusText(1)Mトランザクション・ステータスは、2に等しい場合、トランザクションが成功したことを意味し、それ以外の値はトランザクションが失敗したことを意味する。
支払いシーンpay_scenarioText(32)O支払いシーン, 見る PayScenario
Example：BSCANQR_PAY
支払い方法IDpay_method_idText(32)O支払い方法番号。支払い方法を指定する場合, 見る ペイメソッド
例：Alipay
注文金額order_amountAmountM引用通貨で表示,主に円をサポート
取引タイプtrans_typeNumberMトランザクション・タイプ, 見る トランスタイプ, 現在、消費と払い戻しのみがサポートされています
例：1
マーチャントシステム注文番号merchant_order_noText(32)M払い戻しは、払い戻しに適用される注文番号とし、元の消費取引の注文番号とは異なるものとする。