Création de paiements et de transferts distincts

Configurer votre intégration

Pour utiliser Google Pay, commencez par activer l’API Google Pay en ajoutant les informations suivantes au libellé <application> de votre AndroidManifest.xml :

<application>
  ...
  <meta-data
    android:name="com.google.android.gms.wallet.api.enabled"
    android:value="true" />
</application>

Pour en savoir plus, consultez cette page indiquant comment configurer l’API Google Pay pour Android.

Ajouter Google Pay

Pour ajouter Google Pay à votre intégration, transmettez un PaymentSheet.GooglePayConfiguration avec votre environnement Google Pay (en mode production ou en mode test), ainsi que le code pays de votre entreprise lors de l’initialisation de PaymentSheet.Configuration.

val googlePayConfiguration = PaymentSheet.GooglePayConfiguration(
  environment = PaymentSheet.GooglePayConfiguration.Environment.Test,
  countryCode = "US",
  currencyCode = "USD" // Required for Setup Intents, optional for Payment Intents
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "My merchant name")
  .googlePay(googlePayConfiguration)
  .build()

Tester Google Pay

Google vous permet d’effectuer des paiements tests par le biais de sa suite de cartes de test. La suite de test prend en charge l’utilisation des cartes de test Stripe.

Vous pouvez tester Google Pay à l’aide d’un appareil Android physique. Assurez-vous d’avoir un appareil dans un pays où Google Pay est pris en charge et connectez-vous à un compte Google sur votre appareil de test avec une vraie carte enregistrée dans Google Wallet.

Pour personnaliser le formulaire de paiement, vous devez obligatoirement utiliser l’objet PaymentSheet.Configuration.

Appearance

Personnalisez les couleurs, les polices et même plus afin de vous adapter à l’apparence de votre application en utilisant l’API Appearance.

Mise en page des moyens de paiement

Configurez la mise en page des moyens de paiement dans la feuille à l’aide de paymentMethodLayout. Vous pouvez les afficher horizontalement, verticalement ou laisser Stripe optimiser la mise en page automatiquement.

PaymentSheet.Configuration.Builder("Example, Inc.")
  .paymentMethodLayout(PaymentSheet.PaymentMethodLayout.Automatic)
  .build()

Recueillir les adresses des utilisateurs

Recueillez les adresses de livraison ou de facturation de vos clients locaux et internationaux à l’aide du composant Address Element.

Nom d’affichage de l’entreprise

Spécifiez un nom d’entreprise à afficher pour le client en définissant merchantDisplayName. Par défaut, il s’agit du nom de votre application.

PaymentSheet.Configuration.Builder(
  merchantDisplayName = "My app, Inc."
).build()

Mode sombre

Par défaut, PaymentSheet s’adapte automatiquement aux paramètres d’affichage du système de l’utilisateur (mode clair ou mode sombre). Vous pouvez modifier ce comportement en sélectionnant le mode clair ou le mode sombre sur votre application :

// force dark
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES)
// force light
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO)

Informations de facturation par défaut

Si vous souhaitez définir des valeurs par défaut pour les informations de facturation collectées dans le formulaire de paiement, configurez la propriété defaultBillingDetails. Le PaymentSheet préremplit les champs avec les valeurs que vous fournissez.

val address = PaymentSheet.Address(country = "US")
val billingDetails = PaymentSheet.BillingDetails(
  address = address,
  email = "foo@bar.com"
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "Merchant, Inc.")
  .defaultBillingDetails(billingDetails)
  .build()

Configurer la collecte des données de facturation

Utiliser BillingDetailsCollectionConfiguration pour spécifier la manière dont vous souhaitez collecter les informations de facturation dans la PaymentSheet.

Vous pouvez collecter le nom, l’adresse e-mail, le numéro de téléphone et l’adresse de votre client.

Si vous souhaitez associer les informations de facturation par défaut à l’objet PaymentMethod même lorsque ces champs ne sont pas collectés dans l’interface utilisateur, définissez billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod sur true.

val billingDetails = PaymentSheet.BillingDetails(
  email = "foo@bar.com"
)
val billingDetailsCollectionConfiguration = BillingDetailsCollectionConfiguration(
  attachDefaultsToPaymentMethod = true,
  name = BillingDetailsCollectionConfiguration.CollectionMode.Always,
  email = BillingDetailsCollectionConfiguration.CollectionMode.Never,
  address = BillingDetailsCollectionConfiguration.AddressCollectionMode.Full,
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "Merchant, Inc.")
  .defaultBillingDetails(billingDetails)
  .billingDetailsCollectionConfiguration(billingDetailsCollectionConfiguration)
  .build()

Vous pouvez présenter le formulaire de paiement pour collecter uniquement les informations du moyen de paiement et finaliser l’opération dans l’interface utilisateur de votre application. Cette méthode est utile si vous avez intégré un bouton d’achat personnalisé ou si vous avez besoin d’étapes supplémentaires après la collecte des informations de paiement.

1. Tout d’abord, initialisez PaymentSheet.FlowController au lieu de PaymentSheet en utilisant l’une des méthodes Builder.

class CheckoutActivity : AppCompatActivity() {
  private lateinit var flowController: PaymentSheet.FlowController

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    flowController = PaymentSheet.FlowController.Builder(
      paymentResultCallback = ::onPaymentSheetResult,
      paymentOptionCallback = ::onPaymentOption,
    ).build(this)
  }
}

1. Appelez ensuite configureWithPaymentIntent avec les clés d’objet Stripe récupérées depuis votre back-end et mettez à jour votre interface utilisateur dans le rappel en utilisant getPaymentOption(). Cette propriété contient une image et une étiquette représentant le moyen de paiement actuellement sélectionné par le client.

flowController.configureWithPaymentIntent(
  paymentIntentClientSecret = paymentIntentClientSecret,
  configuration = PaymentSheet.Configuration.Builder("Example, Inc.")
    .customer(PaymentSheet.CustomerConfiguration(
      id = customerId,
      ephemeralKeySecret = ephemeralKeySecret
    ))
    .build()
) { isReady, error ->
  if (isReady) {
    // Update your UI using `flowController.getPaymentOption()`
  } else {
    // handle FlowController configuration failure
  }
}

1. Appelez ensuite presentPaymentOptions pour collecter les informations de paiement. Lorsque le client a terminé, le formulaire se ferme et appelle le paymentOptionCallback transmis plus tôt dans create. Implémentez cette méthode pour mettre à jour votre interface utilisateur avec la propriété paymentOption renvoyée.

// ...
  flowController.presentPaymentOptions()
// ...
  private fun onPaymentOption(paymentOption: PaymentOption?) {
    if (paymentOption != null) {
      paymentMethodButton.text = paymentOption.label
      paymentMethodButton.setCompoundDrawablesRelativeWithIntrinsicBounds(
        paymentOption.drawableResourceId,
        0,
        0,
        0
      )
    } else {
      paymentMethodButton.text = "Select"
      paymentMethodButton.setCompoundDrawablesRelativeWithIntrinsicBounds(
        null,
        null,
        null,
        null
      )
    }
  }

1. Enfin, appelez confirm pour mener à bien le paiement. Lorsque le client a terminé, le formulaire se ferme et appelle le paymentResultCallback transmis plus tôt dans create.

// ...
    flowController.confirmPayment()
  // ...

  private fun onPaymentSheetResult(
    paymentSheetResult: PaymentSheetResult
  ) {
    when (paymentSheetResult) {
      is PaymentSheetResult.Canceled -> {
        // Payment canceled
      }
      is PaymentSheetResult.Failed -> {
        // Payment Failed. See logcat for details or inspect paymentSheetResult.error
      }
      is PaymentSheetResult.Completed -> {
        // Payment Complete
      }
    }
  }

Si vous définissez allowsDelayedPaymentMethods sur true, les moyens de paiement à notification différée, comme les comptes bancaires étasuniens, seront acceptés. Pour ces moyens de paiement, l’état final du paiement n’est pas connu une fois le processus du PaymentSheet achevé, et le paiement peut plus tard aboutir comme échouer. Si vous prenez en charge ces types de moyens de paiement, informez votre client que sa commande est confirmée et ne la traitez (en lui expédiant son produit, par exemple) qu’une fois le paiement reçu.

Naviguez vers la page Gérer les moyens de paiement pour vos comptes connectés dans le Dashboard pour configurer les moyens de paiement acceptés par vos comptes connectés. Les modifications apportées aux paramètres par défaut s’appliqueront à tous les comptes connectés, nouveaux et existants.

Consultez les ressources suivantes pour obtenir des informations sur les moyens de paiement :

• Un guide des moyens de paiement pour vous aider à choisir les moyens de paiement adaptés à votre plateforme.
• Fonctionnalités du compte pour vérifier que les moyens de paiement que vous avez choisis sont compatibles avec vos comptes connectés.
• Les tableaux des moyens de paiement pris en charge par produit pour vérifier que les moyens de paiement que vous avez choisis sont compatibles avec vos produits et tunnels de paiement Stripe.

Pour chaque moyen de paiement, vous pouvez sélectionner l’une des options suivantes de la liste déroulante :

Options des moyens de paiement

Si vous apportez une modification à un moyen de paiement, vous devez cliquer sur Vérifier les modifications dans la barre en bas de l’écran, puis sur Enregistrer et appliquer pour mettre à jour vos comptes connectés.

Boîte de dialogue d’enregistrement

Autoriser vos comptes connectés à gérer leurs moyens de paiement

Stripe recommande d’autoriser vos comptes connectés à personnaliser leurs propres moyens de paiement. Cette option permet à chaque compte connecté ayant accès au Dashboard Stripe d’afficher et de mettre à jour leur page de Moyens de paiement. Seuls les propriétaires des comptes connectés peuvent personnaliser leurs moyens de paiement. Le Dashboard Stripe affiche l’ensemble des moyens de paiement par défaut que vous avez appliqués à tous les comptes connectés, nouveaux comme existants. Vos comptes connectés peuvent remplacer ces valeurs par défaut, à l’exception des moyens de paiement que vous avez bloqués.

Cochez la case Personnalisation de compte pour activer cette option. Vous devez cliquer sur Vérifier les modifications dans la barre en bas de l’écran, puis sélectionner Enregistrer et appliquer pour mettre à jour ce paramètre.

Case à cocher Personnalisation de compte

Fonctionnalités liées aux moyens de paiement

Pour permettre à vos comptes connectés d’accepter des moyens de paiement supplémentaires, vous devez vous assurer qu’ils disposent de fonctionnalités actives pour chaque moyen de paiement. La plupart des moyens de paiement ont les mêmes exigences de vérification que la fonctionnalité card_payments, avec quelques restrictions et exceptions. Le tableau des fonctionnalités des modes de paiement répertorie les moyens de paiement qui nécessitent une vérification supplémentaire par rapport aux cartes.