Przelewy24 での支払いを受け付ける
ポーランドで最もよく利用されている支払い方法である Przelewy24 (P24) を受け付ける方法をご紹介します。
注意
サーバー側での手動確定を使用する必要がある場合、またはお使いの実装で決済手段を別途表示する必要がある場合を除き、決済を受け付けるガイドに従うことをお勧めします。すでに Elements との連携が完了している場合は、Payment Element 移行ガイドをご覧ください。
Przelewy24 は 1 回限りの使用の決済手段であり、顧客は支払いの認証を求められます。Przelewy24 を使用して支払う場合、顧客はお客様のウェブサイトからリダイレクトされ、支払いを承認するとウェブサイトに戻されます。ここで、お客様は支払いが成功したか失敗したかに関する即時通知を受け取ります。
Stripe を設定するサーバ側クライアント側
まず、Stripe アカウントが必要です。今すぐ登録してください。
サーバ側
この組み込みには、サーバ上に Stripe API と通信するエンドポイントが必要です。サーバから Stripe API にアクセスするには、Stripe の公式ライブラリを使用します。
クライアント側
Stripe Android SDK はオープンソースであり、詳細なドキュメントが提供されています。
SDK をインストールするには、app/build.gradle ファイルの dependencies
ブロックに stripe-android
を追加します。
注
SDK の最新リリースおよび過去バージョンの詳細については、GitHub の Releases ページをご覧ください。新しいリリースの公開時に通知を受け取るには、リポジトリのリリースを確認してください。
Stripe の公開可能キーを使用して SDK を設定し、 Application
サブクラスなどで、Stripe API へのリクエストを実行できるようにします。
PaymentIntent を作成するサーバ側クライアント側
PaymentIntent (支払いインテント) は、顧客から支払いを回収する意図を示し、支払いプロセスのライフサイクルを追跡します。
サーバ側
サーバーで PaymentIntent
を作成し、回収する amount
を指定し、通貨として eur
または pln
を指定します。既存の Payment Intents のシステムがある場合は、p24
を決済手段タイプのリストに追加します。
PaymentIntent オブジェクト全体をアプリに渡す代わりに、その client secret を返します。PaymentIntent の client secret は、支払い額などの機密情報の操作を許可することなく、クライアント側で支払いを確定し、支払い情報の詳細を更新できる一意のキーです。
クライアント側
クライアントで、サーバの PaymentIntent をリクエストし、その client secret を保存します。
Przelewy24 での明細書表記
PaymentIntent を確定する前に、カスタムの明細書表記を設定できます。Przelewy24 では、明細書表記は 14 文字以内に制限されています。顧客の銀行記録で支払いの説明に /OPT/X/////P24-XXX-XXX-XXX {statement_
の形式で表示されます。/OPT/X/////P24-XXX-XXX-XXX
は、Przelewy24 によって生成された支払いの一意の参照表記です。
支払い方法の詳細を収集するクライアント側
アプリで、顧客のメールアドレスを収集します。請求詳細を使用して PaymentMethodCreateParams
を作成します。
Stripe に支払いを送信するクライアント側
作成した PaymentIntent から client secret を取得し、PaymentLauncher confirm を呼び出します。これにより、Webview が表示され、顧客はここで支払いを完了できます。完了後、支払い結果とともに onPaymentResult
が呼び出されます。