Enregistrer directement les informations sans débiter le client

Créer ou récupérer un objet Customer

Pour débiter une carte bancaire enregistrée auprès de Stripe, celle-ci doit être associée à un objet Customer.

Lorsque vous ajoutez un client à votre SetupIntent avant de confirmer, Stripe associe automatiquement le moyen de paiement par carte généré à l’objet Customer fourni.

Ajoutez le code suivant sur votre serveur pour créer un nouvel objet Customer.

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Créer un SetupIntent

Un SetupIntent est un objet qui représente votre intention de configurer le moyen de paiement d’un client en vue de futurs paiements. Le SetupIntent suit les étapes de ce processus de configuration. Dans le cas de Terminal, cela inclut la collecte et l’enregistrement du consentement du titulaire de carte.

Vous pouvez créer un SetupIntent et fournir les paramètres customer, onBehalfOf (Connect uniquement) et usage.

val params = SetupIntentParameters.Builder()
    .setCustomer(
"{{CUSTOMER_ID}}")
    .build()

Terminal.getInstance().createSetupIntent(
    params, object : SetupIntentCallback {
        override fun onSuccess(setupIntent: SetupIntent) {
            // Placeholder for handling successful operation
        }

        override fun onFailure(e: TerminalException) {
            // Placeholder for handling exception
        }
    }
)

Si les informations nécessaires pour démarrer un paiement ne sont pas disponibles dans votre application, vous pouvez créer le SetupIntent sur votre serveur. Utilisez la clé secrète du client pour appeler retrieveSetupIntent, puis utilisez le SetupIntent récupéré pour appeler processSetupIntent.

Collecter un moyen de paiement pour l’enregistrement

Après avoir créé un SetupIntent, vous devez ensuite collecter un moyen de paiement avec le SDK et obtenir le consentement du client. Transmettez allowRedisplay avec la valeur always ou limited. Cette valeur indique le degré d’affichage d’un moyen de paiement dans le tunnel de paiement d’un client.

Pour traiter un setupIntent, assurez-vous d’être connecté à un lecteur. Le lecteur connecté attend qu’une carte soit présentée après que votre application a appelé processSetupIntent.

val config = CollectSetupIntentConfiguration.Builder()
    .build()

val cancelable = Terminal.getInstance().processSetupIntent(
    setupIntent,
    AllowRedisplay.ALWAYS,
    config,
    object : SetupIntentCallback {
        override fun onSuccess(setupIntent: SetupIntent) {
            // Placeholder for handling successful operation
        }

        override fun onFailure(e: TerminalException) {
            // Placeholder for handling exception
        }
    }
)

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

Annuler la collecte

Annulation programmatique

Vous pouvez annuler la collecte d’un moyen de paiement à l’aide de l’objet Cancelable renvoyé par le SDK.

Annulation initiée par le client

Le paramètre CustomerCancellation est activé par défaut. Les utilisateurs de lecteurs intelligents voient donc un bouton d’annulation. Le fait d’appuyer sur le bouton d’annulation permet d’annuler la transaction active. Utilisez setCustomerCancellation pour activer cette fonctionnalité lors d’une transaction.

Terminal.getInstance().collectSetupIntentPaymentMethod(
    setupIntent,
    AllowRedisplay.ALWAYS,
    SetupIntentConfiguration.Builder()
        .build(),
    object : SetupIntentCallback {
        override fun onSuccess(setupIntent: SetupIntent) {
            // Placeholder for handling successful operation
        }

        override fun onFailure(e: TerminalException) {
            // Placeholder for handling exception
        }
    }
)

Envoyer les informations du moyen de paiement à Stripe

Votre appel précédent à processSetupIntent gère la confirmation pour vous, aucune autre action n’est donc nécessaire.

Une fois opérationnelle, la configuration renvoie la valeur succeeded pour la propriété status du SetupIntent, ainsi qu’un SetupAttempt.payment_method_details.card_present.generated_card qui est un moyen de paiement card réutilisable que vous pouvez utiliser pour les paiements en ligne.

Le moyen de paiement generated_card est associé automatiquement au client que vous avez indiqué lors de la création du SetupIntent. Vous pouvez récupérer le moyen de paiement generated_card en développant la propriété latest_attempt du SetupIntent. Vérifiez systématiquement la valeur generated_card ; pour les moyens de paiement qui n’autorisent pas les cartes générées, la valeur est vide.

curl -G https://api.stripe.com/v1/setup_intents/
{{SETUP_INTENT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=latest_attempt

Vous pouvez également récupérer le moyen de paiement associé en récupérant la liste des moyens de paiement associés au client.

curl -G https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}}
/payment_methods \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=card

Si vous n’avez pas fourni de client lors de la création du SetupIntent, vous pouvez associer le moyen de paiement generated_card à un objet Customer dans un appel distinct.

curl https://api.stripe.com/v1/payment_methods/
{{PAYMENT_METHOD_ID}}
/attach \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}"

Si la configuration n’aboutit pas, examinez l’erreur renvoyée pour en déterminer la cause. Par exemple, omettre de recueillir le consentement du client et d’en informer Stripe entraîne une erreur.

Considérations relatives aux wallets mobiles

Les portefeuilles mobiles enregistrés sont réservés aux paiements off_session tels que les abonnements futurs ou les autres paiements que vous initiez au nom de votre client. Lorsque vous enregistrez un moyen de paiement par portefeuille électronique, la generated_card présente allow_redisplay=limited, pour indiquer ses considérations d’utilisation spécifiques.

Lorsque vous tentez de débiter un portefeuille mobile, veillez à transmettre off_session=true lors de la confirmation PaymentIntent. Si le client est présent dans votre tunnel de paiement, vous devrez plutôt utiliser les intégrations Apple Pay et Google Pay pour demander à nouveau la présentation du moyen de paiement.

Conformité

You’re responsible for your compliance with all applicable laws, regulations, and network rules when saving a customer’s payment details. For example, the European Data Protection Board has issued guidance regarding saving payment details. These requirements generally apply if you want to save your customer’s payment method for future use. This applies in situations such as presenting a customer’s payment method to them in the checkout flow for a future purchase, or charging them when they’re not actively using your website or app, placing a MOTO order, or in your store.

Add terms to your checkout flow that state how you plan to save payment method details and allow customers to opt in. If you plan to charge the customer while they’re not actively checking out, make sure (at a minimum) that your terms also cover the following:

• Le consentement du client vous autorisant à déclencher un paiement ou une série de paiements en son nom pour les transactions spécifiées
• Le calendrier et la fréquence prévus des paiements (par exemple, si les paiements concernent des versements échelonnés ou d’abonnement planifiés, ou des recharges non planifiées).
• La façon dont vous déterminez le montant du paiement.
• Votre politique d’annulation, si vous configurez le moyen de paiement dans le cadre d’un abonnement

Veillez à conserver une trace écrite de l’acceptation de ces conditions par votre client.

When you save a payment method, you can only use it for the specific purpose that you included in your terms. If you want to charge customers when they’re not actively checking out and also save the customer’s payment method to present to them as a saved payment method for future purchases, you must explicitly collect consent from the customer. One way to do so is with a “Save my payment method for future use” checkbox.