Collecter des informations de compte pour créer des produits basés sur des données

Une fois que vous avez accès au mode production sur votre compte, inscrivez-vous à Financial Connections.

Côté serveur

Pour cette intégration, votre serveur doit disposer de endpoints qui communiquent avec l’API Stripe. Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre serveur :

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Côté client

Le SDK Stripe Android est disponible en open source et fait l’objet d’une documentation complète.

Pour installer le SDK, ajoutez financial-connections au bloc dependencies de votre fichier app/build.gradle :

plugins {
    id("com.android.application")
}

android { ... }

dependencies {
  // ...

  // Financial Connections Android SDK
  implementation("com.stripe:financial-connections:21.20.2")
}

Créez un objet Customer lorsque les utilisateurs créent un compte auprès de votre entreprise. En fournissant une adresse email, vous permettez à Financial Connections d’optimiser le flux d’authentification en présentant de manière dynamique une interface utilisateur simplifiée, pour les utilisateurs existants de Link.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d email={{CUSTOMER_EMAIL}} \
  -d name={{CUSTOMER_NAME}}

Pour que vous puissiez récupérer des données sur le compte bancaire d’un utilisateur avec Financial Connections, votre utilisateur doit au préalable authentifier son compte avec le flux d’authentification.

L’utilisateur lance le flux d’authentification lorsqu’il souhaite connecter son compte à votre site ou votre application. Insérez un bouton ou un lien sur votre site ou dans votre application pour permettre à l’utilisateur d’associer ses comptes : par exemple, « Associer votre compte bancaire ».

Créez une session Financial Connections en envoyant une requête POST à /v1/financial_connections/sessions :

curl https://api.stripe.com/v1/financial_connections/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "account_holder[type]"=customer \
  -d "account_holder[customer]"=
{{CUSTOMER_ID}} \
  -d "permissions[]"=balances \
  -d "permissions[]"=ownership \
  -d "permissions[]"=payment_method \
  -d "permissions[]"=transactions

1. Définissez account_holder[customer] sur l’id du client.
2. Définissez le paramètre de données permissions afin d’inclure les données nécessaires à votre cas d’usage.
3. (Facultatif) Définissez le paramètreprefetch pour récupérer les données lors de la création du compte.

Le paramètre permissions détermine les données du compte auxquelles vous pouvez accéder. Vous devez demander au moins une autorisation. Après s’être soumis au flux d’authentification, votre utilisateur peut voir les données auxquelles vous avez demandé l’accès et donner son accord pour qu’elles soient partagées.

Réfléchissez aux données dont vous aurez besoin pour votre cas d’usage, et demandez uniquement l’accès aux données nécessaires. Le fait de demander des autorisations dont vous n’avez pas besoin pour votre application risque d’éroder la confiance que vous accordent vos utilisateurs quant à la manière dont vous utilisez leurs données. Par exemple, si vous créez une application de gestion financière personnelle ou un produit de location, vous pouvez demander les données transactions d’un utilisateur. Si vous cherchez à réduire les risques de fraude et à empêcher les usurpations de comptes, vous pouvez demander les données ownership.

Une fois que l’utilisateur a authentifié son compte, vous ne pouvez étendre les autorisations d’accès aux données qu’en créant une nouvelle session Financial Connections et en spécifiant une nouvelle valeur pour le paramètre permissions. Votre utilisateur doit se soumettre à nouveau au flux d’authentification dans lequel il peut consulter les données supplémentaires auxquelles vous souhaitez accéder et autoriser le partage de ses données.

Le paramètre prefetch facultatif contrôle les données que vous récupérez immédiatement après que l’utilisateur s’est connecté à son compte. Utilisez cette option si vous savez que vous voulez toujours un certain type de données. Il n’est pas nécessaire d’effectuer un appel supplémentaire à l’API pour lancer une actualisation des données.

Pour conserver la possibilité d’accepter les paiements par prélèvement automatique ACH, demandez l’autorisation payment_method.

Avant d’afficher le flux de Financial Connections, le bouton Connecter le compte financier doit être inclus dans votre page afin d’afficher l’interface utilisateur de Stripe.

Initialisez une instance FinancialConnectionsSheet dans onCreate au niveau de votre activité de paiement, en transférant une méthode pour traiter le résultat.

import com.stripe.android.financialconnections.FinancialConnectionsSheet

class MyHostActivity : AppCompatActivity() {
  lateinit var financialConnectionsSheet: FinancialConnectionsSheet

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    financialConnectionsSheet = FinancialConnectionsSheet.create(this, ::onFinancialConnectionsSheetResult)
  }

  fun onFinancialConnectionsSheetResult(result: FinancialConnectionsSheetResult) {
    // implemented in the next steps
  }
}

Ensuite, récupérez la clé secrète du client FinancialConnectionsSession, ainsi que la clé publiable du endpoint que vous avez créé à l’étape précédente. Définissez ces champs en utilisant FinancialConnectionsSheet.Configuration et sauvegardez les autres pour les utiliser au moment d’afficher FinancialConnectionsSheet.

import com.stripe.android.financialconnections.FinancialConnectionsSheet
// Add the following lines to build.gradle to use this example's networking library:
//   implementation 'com.github.kittinunf.fuel:fuel:2.3.1'
//   implementation 'com.github.kittinunf.fuel:fuel-json:2.3.1'
import com.github.kittinunf.fuel.httpPost
import com.github.kittinunf.fuel.json.responseJson
import com.github.kittinunf.result.Result

class MyHostActivity : AppCompatActivity() {
  lateinit var financialConnectionsSheet: FinancialConnectionsSheet
  lateinit var clientSecret: String
  lateinit var publishableKey: String

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    financialConnectionsSheet = FinancialConnectionsSheet.create(this, ::onFinancialConnectionsSheetResult)
    "Your backend endpoint/connections-sheet".httpPost().responseJson { _, _, result ->
      if (result is Result.Success) {
        val responseJson = result.get().obj()
        clientSecret = responseJson.getString("financialConnectionsSessionClientSecret")
        publishableKey = responseJson.getString("publishableKey")
      }
    }
  }

  fun onFinancialConnectionsSheetResult(result: FinancialConnectionsSheetResult) {
    // implemented in the next steps
  }
}

Lorsque le client appuie sur votre bouton Connecter le compte financier, appelez FinancialConnectionsSheet#present pour afficher le formulaire Financial Connections. Le formulaire se ferme une fois que la connexion est effectuée. Le FinancialConnectionsSheetResultCallback que vous avez déclaré à l’étape précédente est appelé avec FinancialConnectionsSheetResult.

// ...
class MyHostActivity : AppCompatActivity() {
  lateinit var financialConnectionsSheet: FinancialConnectionsSheet
  lateinit var clientSecret: String
  lateinit var publishableKey: String
  // ...
  fun presentFinancialConnectionsSheet() {
    financialConnectionsSheet.present(
      configuration = FinancialConnectionsSheet.Configuration(
        financialConnectionsSessionClientSecret = clientSecret,
        publishableKey = publishableKey
      )
    )
  }

  fun onFinancialConnectionsSheetResult(result: FinancialConnectionsSheetResult) {
    when(result) {
      is FinancialConnectionsSheetResult.Canceled -> {
        print("Canceled")
      }
      is FinancialConnectionsSheetResult.Failed -> {
        print("Failed")
        print("${result.error}")
      }
      is FinancialConnectionsSheetResult.Completed -> {
        // Display for example, a list of accounts.
        val accountInfos = result.financialConnectionsSession.accounts.data
          .map { "${it.institutionName} ${it.last4}" }
        print("Completed with ${accountInfos.joinToString("\n")} accounts")
      }
    }
  }
}

Une fois que votre utilisateur a terminé le flux d’authentification, mettez à jour ou accédez aux données du compte que vous avez précisé dans le paramètre permissions de la session Financial Connections.

Pour protéger la confidentialité des données de votre utilisateur, vous n’avez accès qu’aux données indiquées dans le paramètre permissions.

Suivez les instructions des guides consacrés aux soldes, à la propriété et aux transactions pour commencer à récupérer les données d’un compte.