Filtrer les financements de la carte bancaire pour Payment ElementVersion bêta privée

Sélectionnez les types de financement de la carte bancaire que vous souhaitez accepter.

Vous souhaitez accéder au filtrage par source de financement de carte ?

Le filtrage par source de financement de carte est en version bêta privée. Envoyez votre adresse e-mail pour demander l’accès.

Utilisez cette API pour contrôler les types de financement de la carte bancaire que vous acceptez. Le filtrage des financements de la carte bancaire vous permet de spécifier les types de financement autorisés pour :

Le formulaire de carte bancaire dans les paiements de l’application
Moyens de paiement enregistrés
The cards that customers can use with Apple Pay and Link

Indiquez les types de financement de la carte bancaire à autoriser à l’aide de la propriété allowedCardFundingTypes. Si vous ne définissez pas cette propriété, tous les types de financement sont acceptés par défaut.

Ce guide explique comment utiliser le filtrage des financements de la carte bancaire pour n’accepter que les cartes de débit.

Avant de commencer

Créez un compte Stripe ou connectez-vous.
Vous devez d’abord créer une intégration du composant Mobile Payment Element.

Filtrer les financements de la carte bancaire

Lorsque vous créez un objet EmbeddedPaymentElement.Configuration, indiquez les types de financement de la carte bancaire que vous souhaitez autoriser à l’aide de la propriété allowedCardFundingTypes. Transmettez n’importe quelle combinaison des valeurs suivantes définies dans PaymentSheet.CardFundingType :

.debit
.credit
.prepaid
.unknown

Mise en garde

Le filtrage des financements de la carte bancaire affiche un message d’avertissement aux clients, mais n’empêche pas l’envoi du formulaire. Vérifiez toujours le type de financement de la carte bancaire sur votre serveur en vérifiant le champ de financement de l’objet ConfirmationToken ou PaymentMethod avant de confirmer le paiement.

Cet exemple montre comment autoriser uniquement les cartes de débit :

@_spi(CardFundingFilteringPrivatePreview) import StripePaymentSheet

class MyCheckoutVC: UIViewController {
  func createEmbeddedPaymentElement() async throws -> EmbeddedPaymentElement {
      // ...
      var configuration = EmbeddedPaymentElement.Configuration()
      configuration.allowedCardFundingTypes = .debit
      // ...
  }
}

Pour autoriser plusieurs types de financement, utilisez un tableau :

configuration.allowedCardFundingTypes = [.debit, .credit]

Validez le type de financement avant de confirmer

Vous devez valider le type de financement sur votre serveur avant de confirmer le paiement, car les clients peuvent toujours tenter une confirmation indépendamment du filtrage côté client.

Lorsque le client soumet le formulaire de paiement, récupérez letoken de confirmation sur votre serveur et vérifiez son type de financement avant de créer le PaymentIntent :

const confirmationToken = await stripe.confirmationTokens.retrieve(confirmationTokenId);

const funding = confirmationToken.payment_method_preview?.card?.funding;
const allowedFundingTypes = ['debit'];

if (funding && !allowedFundingTypes.includes(funding)) {
  throw new Error('Only debit cards are accepted');
}

// Proceed with creating the PaymentIntent
const paymentIntent = await stripe.paymentIntents.create({
  amount: 1099,
  currency: 'usd',
  confirmation_token: confirmationTokenId,
  confirm: true,
});

Tester votre intégration

Utilisez les numéros de carte bancaire de test de Stripe pour tester votre tunnel de paiement et vérifier que le composant Mobile Payment Element affiche les alertes pour les types de financement de la carte bancaire non autorisés.

Numéro	Type de financement
	Carte de crédit
	Carte de débit
	Carte prépayée

Le composant Mobile Payment Element lorsqu’un type de financement de la carte bancaire n’est pas autorisé