Encaissement des paiements par carte

La première étape dans l’encaissement d’un paiement consiste à démarrer le tunnel de paiement. Lorsque le client commence à payer, votre application doit créer un objet PaymentIntent. Celui-ci représente une nouvelle session de paiement sur Stripe.

Vous pouvez créer un PaymentIntent côté client ou côté serveur.

Utilisez des montants test pour essayer d’obtenir des résultats différents. Un montant se terminant par 00 correspond à un paiement approuvé.

Côté client

Créez un PaymentIntent pour votre client :

const {error, paymentIntent} = await createPaymentIntent({
  amount: 1000,
  currency: "usd",
});

Côté serveur

Vous pouvez créer le PaymentIntent sur votre serveur si les informations requises pour lancer un paiement ne sont pas facilement accessibles dans votre application.

L’exemple suivant montre comment créer un PaymentIntent sur votre serveur :

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1000 \
  -d "currency"="usd" \
  -d "payment_method_types[]"="card_present" \
  -d "capture_method"="manual"

Pour les paiements Terminal, le paramètre payment_method_types doit inclure l’option card_present.

Vous pouvez contrôler le tunnel de paiement de la manière suivante :

• Pour contrôler totalement le tunnel de paiement pour les paiements card_present, définissez le paramètre capture_method sur manual. Cela vous permet d’ajouter une étape de rapprochement avant la réalisation du paiement.
• Pour capturer et autoriser simultanément des paiements, définissez le paramètre capture_method sur automatic.

Pour accepter des paiements en Australie, vous devez définir lle paramètre capture_method sur automatic ou sur manual_preferred. Pour en savoir plus, consultez notre documentation sur l’Australie. Pour accepter les paiements Interac au Canada, vous devez également inclure interac_present dans payment_method_types. Pour en savoir plus, consultez notre documentation sur le Canada.

Le PaymentIntent contient une clé secrète du client, une clé unique propre à chaque PaymentIntent. Pour utiliser la clé secrète du client, vous devez l’obtenir du PaymentIntent sur votre serveur et la transmettre côté client.

post '/create_payment_intent' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

Pour récupérer un PaymentIntent, utilisez la clé secrète du client pour appeler retrievePaymentIntent.

Après avoir récupéré le PaymentIntent, utilisez-le pour appeler collectPaymentMethod.

const { paymentIntent, error } = await retrievePaymentIntent(clientSecret);

if (error) {
  // Placeholder for handling exception
  return;
}

// Placeholder for collecting payment method

Une fois que vous avez créé un PaymentIntent, il vous faut ensuite recueillir un moyen de paiement avec le SDK.

Pour collecter un moyen de paiement, votre application doit être connectée à un lecteur. Le lecteur connecté attend qu’une carte soit présentée après l’appel de votre application collectPaymentMethod.

const { paymentIntent, error } = await collectPaymentMethod({ paymentIntent: paymentIntent });

if (error) {
  // Placeholder for handling exception
}

// Placeholder for processing PaymentIntent

Cette méthode recueille les données chiffrées du moyen de paiement à l’aide du lecteur de carte connecté, et les associe au PaymentIntent local.

Examen facultatif des informations du moyen de paiement

Vous pouvez également examiner les informations de moyen de paiement de la carte présentée et effectuer votre propre logique métier avant l’autorisation, ce qui peut être utile pour les cas d’usage avancés.

Utilisez le paramètre updatePaymentIntent pour associer un PaymentMethod au PaymentIntent côté serveur. Ces données sont renvoyées dans la réponse collectPaymentMethod.

const { paymentIntent, error } = await collectPaymentMethod({
  paymentIntent: paymentIntent,
  updatePaymentIntent: true,
});

if (error) {
  // Placeholder for handling exception
}

// Placeholder for processing PaymentIntent

Cette méthode associe les données chiffrées collectées du moyen de paiement avec une mise à jour de l’objet PaymentIntent. Elle ne nécessite pas d’autorisation tant que vous n’avez pas confirmé le paiement. Ce cas d’usage avancé n’est pas pris en charge sur le Verifone P400.

Une fois le moyen de paiement encaissé, vous devez autoriser le paiement ou annuler le recouvrement dans les 30 secondes.

Si le SDK fonctionne hors ligne, le champ paymentMethod n’est pas présent dans l’objet PaymentIntent.

À ce stade, vous pouvez accéder à des attributs tels que la marque de la carte, le financement et d’autres données utiles.

Stripe tente de détecter si un portefeuille mobile est utilisé dans une transaction, comme indiqué dans l’attribut wallet.type. Cependant, l’attribut n’est pas renseigné si la banque émettrice de la carte ne prend pas en charge l’identification par lecteur d’un portefeuille mobile, une détection précise n’est donc pas garantie. Après l’autorisation à l’étape de confirmation, Stripe reçoit des réseaux des informations actualisées afin de mettre à jour wallet.type de manière fiable.

Annuler la collecte

Annulation programmatique

Vous pouvez annuler le débit du moyen de paiement en appelant cancelCollectPaymentMethod dans le SDK React Native.

Annulation initiée par le client

Lorsque vous définissez enableCustomerCancellation sur la valeur « true » pour une transaction, les utilisateurs de lecteurs intelligents voient apparaître un bouton d’annulation.

Appuyer sur le bouton d’annulation annule la transaction active.

const { paymentIntent, error } = await collectPaymentMethod({
  paymentIntent: paymentIntent,
  enableCustomerCancellation: true
});

if (error) {
  // Placeholder for handling exception
}

// Placeholder for processing PaymentIntent

Gérer les événements

Lorsque vous collectez un moyen de paiement à l’aide d’un lecteur tel que le Stripe M2sans écran intégré, votre application doit être en mesure d’afficher les événements du processus de collecte du moyen de paiement aux utilisateurs. Ces événements aident les utilisateurs à encaisser les paiements (par exemple, réessayer une carte, essayer une autre carte ou utiliser une autre méthode de lecture).

Au début d’une transaction, le SDK adresse une valeur ReaderInputOptions`` au gestionnaire d'affichage du lecteur de votre application, précisant les types de saisie acceptables (par exemple, Swipe, Insert, ou Tap`). Dans l’interface de paiement de l’application, invitez l’utilisateur à effectuer son paiement par carte selon l’une de ces options.

Au cours de la transaction, le SDK peut recourir à l’application pour afficher d’autres messages à l’attention de l’utilisateur (Réessayer la carte, par exemple) en transmettant une valeur ReaderDisplayMessage au gestionnaire d’affichage du lecteur de votre application. Vérifiez que l’interface de paiement relaie bien ces messages à l’utilisateur.

useStripeTerminal({
  onDidRequestReaderInput: (options) => {
    // Placeholder for updating your app's checkout UI
    Alert.alert(options.join('/'));
  },
  onDidRequestReaderDisplayMessage: (message) => {
    Alert.alert(message);
  },
});

Après avoir collecté un moyen de paiement auprès du client, vous devez traiter le paiement avec le SDK. Au moment de procéder au paiement, appelez confirmPaymentIntent avec la PaymentIntent misa à jour lors de l’étape 2.

• En cas de capture manuelle des paiements, un appel confirmPayment réussi génère une PaymentIntent à l’état requires_capture.
• En cas de capture automatique d’un paiement, le PaymentIntent passe à l’état succeeded.

Confirmez toujours les PaymentIntents à l’aide du SDK Terminal côté client. La confirmation côté serveur contourne les interactions critiques, telles que les invites de code PIN, et peut entraîner l’échec des transactions.

const { paymentIntent, error } = await confirmPaymentIntent({ paymentIntent: paymentIntent });

if (error) {
  // Placeholder for handling exception
  return;
}

// Placeholder for notifying your backend to capture paymentIntent.id

Vous devez capturer un PaymentIntent manuellement sous deux jours, faute de quoi l’autorisation expire et les fonds sont restitués au client.

Gérer les échecs

Lorsque la confirmation d’un paiement échoue, le SDK renvoie une erreur qui inclut la PaymentIntent mise à jour. Votre application doit inspecter la PaymentIntent pour décider comment traiter l’erreur.

Si vous rencontrez plusieurs expirations du délai paiement à la suite, il se peut qu’il y ait un problème de connectivité. Assurez-vous que votre application est connectée à Internet.

Éviter les doublons de paiement

L’objet PaymentIntent active les mouvements de fonds sur Stripe : utilisez un seul PaymentIntent pour représenter une transaction.

Réutilisez le même PaymentIntent même après le refus d’une carte (par exemple, pour fonds insuffisants), afin que votre client puisse réessayer avec une autre carte.

Si vous modifiez la PaymentIntent, vous devez appeler collectPaymentMethod pour mettre à jour les informations de paiement sur le lecteur.

Une PaymentIntent doit être à l’état requires_payment_method pour que Stripe puisse la confirmer. Une PaymentIntent autorisée, capturée ou annulée ne peut pas être confirmée par un lecteur.

Si vous avez défini capture_method sur manual lors de la création du PaymentIntent à l’étape 1, le SDK renvoie à votre application un PaymentIntent autorisé, mais non capturé. En savoir plus sur la différence entre autorisation et capture.

Assurez-vous que votre application demande à votre back-end de capturer le paiement lorsqu’elle reçoit du SDK un PaymentIntent confirmé. Créez dans votre back-end un endpoint qui accepte un ID de PaymentIntent et envoie à l’API Stripe une demande de capture correspondante :

curl -X POST https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Si l’appel de capture réussit, l’état du PaymentIntent passe à succeeded.

Pour débiter les comptes connectés des frais de plateforme appropriés, inspectez chaque PaymentIntent et modifiez les frais de plateforme, si nécessaire, avant de capturer le paiement manuellement.

Rapprocher les paiements

Pour vérifier l’activité de paiement de votre entreprise, vous pouvez rapprocher les PaymentIntents avec votre système de commande interne sur votre serveur à la fin de chaque journée.

Un PaymentIntent conservant l’état requires_capture peut signifier deux choses :

Autorisation inutile sur le relevé de carte bancaire de votre client

• Cause : l’utilisateur abandonne le tunnel de paiement de votre application au milieu d’une transaction
• Solution : si le PaymentIntent non capturé n’est associé à aucune commande terminée sur votre serveur, vous pouvez l’annuler. Vous ne pouvez pas utiliser un PaymentIntent annulé pour effectuer des paiements.

Encaissement de fonds incomplet auprès d’un client

• Cause : échec de la requête de votre application signalant à votre back-end de capturer le paiement
• Solution : si le PaymentIntent non capturé est associé à une commande terminée sur votre serveur, et aucun autre paiement n’a été encaissé pour la commande (par exemple, un paiement en espèces), vous pouvez le capturer.

Encaisser les pourboires États-Unis uniquement

In the US, eligible users can collect a tip on the receipt when capturing payments.