Issuing でデジタルウォレットを使用する

Stripe はプッシュプロビジョニング用にプライベート Google ライブラリで SDK ラッパーを提供しています。プッシュプロビジョニングを使用して Google Pay Store でアプリを配信するには、以下を行う必要があります。

• Google Pay へのアクセスをリクエストします。フォームに入力した後、数時間～ 1 日以内に承認されます。
• 承認を受けた後、Google の TapAndPay プライベート SDK をダウンロードします。TapAndPay SDK のテスト済みの最新バージョンはバージョン 18 です。
• アプリのPush Provisioning API Access Request (Push Provisioning API へのアクセスをリクエスト) を行います。Google の許可リストに追加するアプリケーション ID を指定する必要があります。このプロセスの詳細については、Google のドキュメントをご覧ください。このプロセスが完了すると、Google から Push Provisioning の資格が付与されます。
• Google がプッシュプロビジョニングの資格を付与したら、アプリケーション名、アプリケーション ID、カード ネットワーク、カード名を Stripe に連絡して、このステップを完了してください。

• Google のプライベート SDK をインポートします。
• Stripe の SDK をインポートします。

dependencies {
  [... your dependencies]
  implementation 'com.stripe:stripe-android-issuing-push-provisioning:1.2.2'
}

詳細については、サンプルアプリの各ステップのコードスニペットとリファレンスをご覧ください。このステップについては、サンプルアプリでこれらの SDK をインポートする方法をご覧ください。

• カード用の一時キーを作成するため、バックエンドを準備します。以下のセクションを参照してください。
• PushProvisioningEphemeralKeyProvider を拡張する EphemeralKeyProvider を作成します。一時キープロバイダーは別のアクティビティに渡されるため、Parcelable も実装する必要があります (Parcelable を参照)。詳細については、サンプルアプリを使用して EphemeralKeyProvider を定義する方法をご覧ください。
• Google の仕様に合わせて Google Pay に追加ボタンを実装します。サンプルアプリでは、ブランディングガイドラインに従うボタンの例が提供されています。

ユーザーのカードのステータスを確認するには、listTokens() を使用して、デバイスにすでに表示されているすべてのカードのリストを取得します。返された各オブジェクトの getFpanLastFour() の値を、追加するカードの発行済みの Card オブジェクトにある Stripe の last4 プロパティと比較します。一致しないオブジェクトはすべてレスポンスリストから破棄します。

• 結果のリストが空の場合は、追加しようとしているカードがまだデバイスで提示されていないことを意味します。後述のように、ボタンを表示するための処理を行うことができます。
• 結果リストに TokenInfo オブジェクトが含まれている場合は、getTokenState() を呼び出して、TokenState を確認してください。
  • ステータスが TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION である場合、ユーザーはすでに特定のカードを手動でデバイスへ追加しようと試みています。Google Pay に追加ボタンは表示しますが、Google のドキュメントに概要が示されているように、onActivityResult リスナーを tokenize() メソッドにワイヤリングすることにより、ユーザーがこの状況から回復できるようにします。
  • その他のステータスの場合は、カードはすでにデバイスに登録されています。「Google Pay」ボタンを表示しないでください。

内部テストを開始する前に、必ず、アプリケーション ID を Stripe に提供してください。設定には 1 週間以上かかり、設定が不完全である場合には、これらの 2 つのメソッドに対して矛盾したレスポンスを受信するといった結果が生じます。listTokens() の結果には、Stripe で設定が完了した後に追加されたカードのみが含まれます。

• ユーザがボタンをタップしたときに、PushProvisioningActivityStarter を使用して Stripe の PushProvisioningActivity を起動します。

new PushProvisioningActivityStarter(
  this, // The Activity or Fragment you are initiating the push provisioning from
  new PushProvisioningActivityStarter.Args(
  "Stripe Card", // The name that will appear on the push provisioning UI
  ephemeralKeyProvider, // Your instance of EphemeralKeyProvider
  false // If you want to enable logs or not
)).startForResult();

詳細については、サンプルアプリを使用して PushProvisioningActivity を開始する方法をご覧ください。

これによってプッシュプロビジョニングが準備され、カードをウォレットに追加する UI が起動されます。onActivityResult にコールバックを実装してください。

protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
  if (requestCode == PushProvisioningActivityStarter.REQUEST_CODE) {
    if (resultCode == PushProvisioningActivity.RESULT_OK) {
      PushProvisioningActivityStarter.Result success = PushProvisioningActivityStarter.Result.fromIntent(data);
    } else if (resultCode == PushProvisioningActivity.RESULT_ERROR) {
      PushProvisioningActivityStarter.Error error = PushProvisioningActivityStarter.Error.fromIntent(data);
    }
  }
}

詳細については、サンプルアプリを使用して onActivityResult を実装する方法をご覧ください。

プロビジョニングが成功すると、PushProvisioningActivityStarter.Result が受信されます。ここには、アクティブなウォレットのカードの Google ID である、cardTokenId が含まれます。この ID を使用してウォレットのその他の機能を使用できます。

プロビジョニングでエラーが発生すると、code と message とともに PushProvisioningActivityStarter.Error が返されます。message は開発者にとって分かりやすく書かれた、エラーを説明するテキストです。 code の値は以下のいずれかです。

プッシュプロビジョニングの実装によって公開されるメソッドでは、お客様が自身のバックエンドとやり取りをし、Stripe の一時キーを作成してその JSON をアプリに返すことが求められます。このキーは有効期間の短い API 認証情報で、暗号化されたカード詳細の取得に使用でき、それがカードオブジェクトの単一インスタンスに使用されます。

Stripe API によって返されるオブジェクトがお使いの iOS または Android の SDK と互換性があることを確認するために、Stripe SDK では、優先される API バージョンを確認できます。キーを作成する際は、Stripe API に対してこの API バージョンを明示的に渡す必要があります。

curl https://api.stripe.com/v1/ephemeral_keys \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "issuing_card"="{{ISSUING_CARD_ID}}" \
  -H "Stripe-Version: {{API_VERSION}}"

{
    "id": "ephkey_1G4V6eEEs6YsaMZ2P1diLWdj",
    "object": "ephemeral_key",
    "associated_objects": [
        {
            "id": "ic_1GWQp6EESaYspYZ9uSEZOcq9",
            "type": "issuing.card"
        }
    ],
    "created": 1586556828,
    "expires": 1586560428,
    "livemode": false,
    "secret": "ek_test_YWNjdF8xRmdlTjZFRHelWWxwWVo5LEtLWFk0amJ2N0JOa0htU1JzEZkd2RpYkpJdnM_00z2ftxCGG"
}

詳細については、サンプルバックエンドで Stripe の一時キーを作成する方法をご覧ください。

テストはすべて、本番環境で本番の Issuing カードを実際のデバイスで使用して行ってください。