Tinkoff Paymentsエクスペリエンス：モバイルSDKが改善され、オンライン支払いがさらに便利になりました

こんにちは！夏の初めに、Tinkoff Acquiring SDKを更新し、AndroidおよびiOS用の2番目のバージョンをリリースしました。Tinkoff Acquiring SDKは、モバイルプラットフォーム用のオープンソースライブラリです。それを使用してアプリケーションで支払いを受け入れると便利です。この記事では、インターネットビジネスの所有者とその購入者にとって何がクールかをお伝えしたいと思います。

改善された点

以前のバージョンにあった問題：

1. 複雑なライブラリアーキテクチャ。このため、開発者はバグの検索と修正に多くの時間を費やしました。
2. 冗長ライブラリAPI。開発者は、SDKを統合するときにしばしば間違いを犯しました。
3. これらの支払い方法を設定するためのApplePayおよびGooglePayの要件は守られていません。

これを修正するために何をしたか、そして他に何が新しいか：

1. 両方のオペレーティングシステムのコードを完全に書き直しました。コードをリファクタリングし、多くの便利な関数を追加しました。ライブラリは現在、KotlinとSwiftで機能します。
2. 高速支払いシステムを追加しました。支払い画面のボタンをクリックすると、QRコードまたは「インスタントアカウント」を使用してSBP経由で支払うことができます。
3. オールインワンソリューションをサポートします。すべてを1か所で：リンクカード、非接触支払い、QRコードを使用した高速支払い。
4. デザインを更新しました。暗いテーマを追加しました。しかし、以前のバージョンにあったAndroidでテーマをカスタマイズすることを忘れませんでした。
5. 以前のバージョンは引き続きサポートされます。私たちはすべてのクライアントについて考え、古いものと新しいものをだましませんでした-SDKは最初と2番目のバージョンで同じように機能します。ただし、新機能を利用するにはアップグレードすることをお勧めします。

そして今、すべてを順番に。

Tinkoff Acquiring SDKとは何ですか？

SDKは、インターネット取得をあらゆるモバイルアプリケーションに統合し、オンラインストア、マーケットプレイス、旅行会社、クリーニング、ストリーミングサイト、フリーランス取引所などのアプリケーションでオンライン支払いを受け入れるビジネスに適しています。



このソリューションは、顧客がアプリケーションでカードをリンクして数回クリックするだけで購入代金を支払うのに役立ち、売り手はアプリケーションをより機能的にして、チェックアウト段階で顧客を失うことがないようにします。



SDKでできることは次のとおり



です。カメラとNFCを使用して銀行カードをスキャンして認識し、保存します。購入者は、アプリケーションでカードを1回リンクし、CVCコードのみを入力して購入の支払いを行います。



アプリケーションですべての種類の支払いを受け入れます。銀行カード、個人アカウントtinkoff.ru、Apple Pay、GooglePayを使用します。定期的な支払いを含みます-つまり、詳細を再入力せずに、サブスクリプションによって自動的に行われます。







Fast Pay System（FPS）を使用して支払います。SDKは、UBSを介した支払いの受け入れに役立ちます。購入者は、注文に関するすべての情報を含むQRコードを使用して商品の支払いを行います。クライアントアプリケーションでの支払いと請求の2つのシナリオを実装しましょう。



オンラインキャッシャーと財政化を維持します。すべてがFZ-54に準拠しています。



アプリケーション設計の支払いウィンドウをカスタマイズします。Androidアプリで利用できます。

アーキテクチャの改善

問題。 SDKコードのアーキテクチャは、新しい機能を維持および実装することが困難で時間がかかるように設計されています。



決定。 SDK開発者は、ライブラリの古いコードの完全なリファクタリングを実行しました：



-コードは最新の言語であるKotlinとSwiftで書かれています。これにより、開発プロセスが加速され、保守と拡張が容易な便利なアーキテクチャの構築に役立ちました。新しい機能の導入が迅速になり、顧客は更新をより迅速に受け取ることができます。最初のバージョンでは、コードはJavaとObjective-Cで記述されています。



-Androidでは、画面設定はKotlinDSLで作成されます。また、すべてのマルチスレッド作業はコルーチン上に構築されています。これらはネットワークへの要求の処理に役立ちますが、ライブラリのサイズは1MB未満しか増加しません。



-プロジェクトでコードの量が削減されました。Generic enum、いくつかの基本クラスのスローと拡張によるエラー処理を使用します。プロジェクトの保守が容易になりました。



-更新されたAPIライブラリ。画面の呼び出し方法と支払いの基本機能は別のクラスに移されました。これは、ライブラリの単一のエントリポイントです。コード全体に散在するよりも、1つの場所からAPIメソッドを呼び出す方がはるかに簡単です。



メソッドの構造は、APIの操作が便利で理解しやすいように設計されています。メソッドは十分に文書化されており、Java、Kotlin、Swiftコードの通常の標準に対応しています。



たとえば、Android SDKで支払い画面の設定が生成され、起動される方法は次のとおりです。

val tinkoffAcquiring = TinkoffAcquiring("terminalKey", "password", "publicKey")
        val paymentOptions = PaymentOptions()
                .setOptions {
                    orderOptions {
                        orderId = "777"
                        amount = Money.ofCoins(1000)
                        title = "Order Title"
                        description = "Order Description"
                    }
                    customerOptions {
                        customerKey = "user-key"
                        checkType = CheckType.HOLD.toString()
                        email = "useremail@gmail.com"
                    }
                    featuresOptions {
                        localizationSource = AsdkSource(Language.RU)
                        useSecureKeyboard = true
                    }
                }
tinkoffAcquiring.openPaymentScreen(this, paymentOptions, PAYMENT_REQUEST_CODE)

IOS SDKの例：

let credentional = AcquiringSdkCredential(terminalKey: "terminalKey", password: "terminalPassword", publicKey: "testPublicKey")
let acquiringSDKConfiguration = AcquiringSdkConfiguration(credential: credentional)

if let sdk = try? AcquiringUISDK.init(configuration: acquiringSDKConfiguration) {
	sdk.presentPaymentView(on: self, paymentData: createPaymentData(), configuration: acquiringViewConfiguration()) { [weak self] (response) in
		self?.responseReviewing(response)
	}
}

SDKは顧客のアプリケーションを制限しません。たとえば、ライブラリ画面だけでなく支払いを受け入れることもできます。ビジネスオーナーとその開発者は、アプリケーションでより多くの機能を必要とする場合があります。



たとえば、チェックアウト画面では、サーバーに対して2つの要求が行われ、売り手はアプリケーションで追加の注文処理を必要とします。したがって、SDK画面が開く前に、要求の1つを実行する必要があり、2番目の要求はすでに画面に表示されている必要があります。我々はそれを行うことができます。



SDKには、このための個別のコアモジュールがあります。これはプラットフォームに依存せず、Tinkoff AcquiringAPIメソッドを呼び出すために使用できます。また、UI部分を備えたモジュールは、SDK画面なしで他のソリューションを提供します。これは、特定の段階から支払い画面を起動する追加の方法です。

GooglePayとApplePay

問題。GoogleとAppleは、SDK支払い画面のカードの横ではなく、アプリ内の個別のボタンとして自分で行う必要のある支払い方法を表示する必要があります。クライアント開発者は、GooglePayとApplePayの設定にさらに多くの作業を行う必要があります。



決定。更新されたSDKにより、GooglePayおよびApplePayを介した支払いの受け入れのサポートが改善されました。



GoogleとAppleの要件を考慮しますが、同時に開発者のタスクを簡素化します。ほとんどの支払い設定はSDKによって処理され、クライアントの開発者はいくつかのメソッドを呼び出すだけで済みます。



これらの方法は次のことを行います。

• GooglePayおよびApplePay支払いサービスの設定。
• デバイス上のサービスの可用性を処理します。
• 支払いのためのサービスコール;
• 支払い結果の処理。

開発者が行う必要があるのは、サービスガイドラインに従ってボタンを作成し、支払い設定を設定し、トークンをSDKに転送して、Tinkoffのインターネット取得を通じて支払いを完了することだけです。

高速支払いシステム

これはフィンテック市場の新機能であり、新技術であるため、開発者は最初からSDKに実装する必要がありました。SBPは、QRコードによる支払いを受け入れ、売り手のアカウントに即座にクレジットを付与するのに役立ちます。週末や休日でも、すぐに届きます。



使い方：

1. 注文の支払い時に、購入者は[SBP経由で支払う]をクリックします。
2. 買い手は銀行の申し込みを入力し、そこでお金の引き出しを確認します。金額はお支払いフォームに記載されます。
3. 支払い後、お金はすぐに売り手の口座に送られます。

お客様は、TinkoffPaymentsの個人アカウントで新しい支払い方法を接続できます。その後、モバイルSDKで、顧客はSBPを介してボタンとQRコードで支払いを受け入れることができるようになります。



「インスタントアカウント」。支払い画面にSBPロゴのボタンが表示されます。



fpsEnabled画面設定には、AndroidSDKのクイックチェックアウトボタンが含まれています。

var paymentOptions = PaymentOptions().setOptions {
    orderOptions { /*options*/ }
    customerOptions { /*options*/ }
    featuresOptions {
        fpsEnabled = true         
    }
}

iOS SDKでは、buttonPaySPBを渡す必要があります。

let viewConfigration = AcquiringViewConfigration.init()
viewConfigration.fields = []
viewConfigration.fields.append(AcquiringViewConfigration.InfoFields.buttonPaySPB)

静的QRコードによる。売り手は自分のデバイスで支払い画面を開く必要があり、買い手は画面からQRコードをスキャンする必要があります。これは、バンキングアプリケーションまたは任意のQRリーダーで実行できます。銀行のモバイルアプリケーションが開き、購入者は注文金額を入力して商品の代金を支払います。



SDKのQRコード支払い画面に対応する方法があります。アプリケーション開発者は、マークアップでボタンを作成し、メソッドを呼び出す必要があります。



Androidの場合：

tinkoffAcquiring.openStaticQrScreen(context, screenOptions, STATIC_QR_REQUEST_CODE)

iOSでの方法：

sdk.presentPaymentSbpQrImage(on: self, paymentData: createPaymentData(), configuration: acquiringViewConfiguration()) { [weak self] (response) in
			self?.responseReviewing(response)
		}

更新されたデザインと暗いテーマ

以前：





現在：





画面の設計に取り組んできました。視覚要素が更新されました。現在、それらはモダンに見え、Tinkoffの企業アイデンティティと一致しています。以前のバージョンと同様に、スタイル属性を使用してテーマのカスタマイズをAndroidに残しました。ウィンドウはカードのように見えるか、全画面で開くことができます。これも属性で簡単に設定できます。



また、SDK画面で、デバイスの水平方向と暗いテーマがサポートされるようになりました。クライアントアプリケーションの設定を維持するために、Android SDKでは、表示設定でダークテーマモードを指定できます。可能な値：「常にオン」、「常にオフ」、「デバイスの設定またはバッテリー節約モードに応じて切り替える」。iOS SDKでは、アプリケーション自体の設定に応じてダークテーマが切り替わります。

画面のローカリゼーション

問題。デバイスにインストールされている言語に応じて、SDKの標準ローカリゼーションを使用しました。一部のクライアントは、高度な画面ローカリゼーション設定を必要としていました。



決定。AndroidSDKの画面ローカリゼーションの拡張サポートを開始しました。これで、デバイスのロケールに依存しなくなりました。任意の言語で独自のローカリゼーションを作成することも、標準のSDKローカリゼーションをインストールすることもできます。ロシア語と英語のローカリゼーションは、引き続き両方のプラットフォームでサポートされています。

使い始める方法

SDKをアプリケーションに統合するには、最初にTinkoffPaymentsインターネット取得に接続する必要があります。迅速です。事業主は申請書を提出し、質問に記入します。データをチェックし、すべてが正常であることを確認したら、SDKの使用を開始できます。通常、これには2日以内かかります。



接続方法ライブラリ、ドキュメントやソースコード、私たちのGitHubを参照してください。



→すべてのAndroid SDK



→ iOSのSDK



あなたが任意のライブラリについての質問、あるいは新しいバージョンへの移行に必要な助けを持っている場合は、ご連絡ください、我々はあなたが理解するのに役立つ：oplata@tinkoff.ruを。または、GitHubの適切なセクションで問題を作成します。