Configurer un abonnement avec Cash App Pay

Les produits correspondent aux articles ou services que vous vendez. Les tarifs définissent le montant et la fréquence des paiements facturés pour un produit. Le tarif prend en compte la valeur du produit, la devise que vous acceptez et s’il s’agit d’un paiement ponctuel ou récurrent. Si vous n’avez que quelques produits et tarifs, créez-les et gérez-les dans le Dashboard.

Ce guide prend comme exemple un service de banque d’images qui débite ses clients d’un montant de 15 USD pour un abonnement mensuel. Pour modéliser ceci :

1. Rendez-vous à la page Ajouter un produit.
2. Saisissez un Nom pour le produit.
3. Saisissez 15 pour le tarif.
4. Sélectionnez la devise USD.
5. Cliquez sur Enregistrer le produit.

Après avoir créé le produit et le tarif, enregistrez l’ID de tarif de manière à pouvoir l’utiliser dans les étapes ultérieures. La page des tarifs affiche l’ID dont le format est similaire à ce qui suit : price_G0FvDp6vZvdwRZ.

Créez un objet SetupIntent pour enregistrer le moyen de paiement d’un client en vue de paiements futurs. Le SetupIntent permet de suivre les étapes de ce processus de configuration.

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d confirm=true \
  --data-urlencode return_url="https://www.stripe.com" \
  -d usage=off_session \
  -d "payment_method_data[type]"=cashapp \
  -d "payment_method_types[]"=cashapp \
  -d "mandate_data[customer_acceptance][type]"=online \
  -d "mandate_data[customer_acceptance][online][ip_address]"="127.0.0.0" \
  -d "mandate_data[customer_acceptance][online][user_agent]"=device

L’objet SetupIntent renvoyé contient une clé secrète à utiliser côté client pour terminer la configuration en toute sécurité, sans avoir à transmettre l’objet SetupIntent dans son intégralité. Vous pouvez utiliser différentes approches pour transmettre cette clé secrète côté client. La réponse du SetupIntent contient également un ID de moyen de paiement, que vous devrez utiliser à l’étape suivante pour confirmer un PaymentIntent.

La réponse du SetupIntent contient l’état requires_action, ce qui signifie que vos utilisateurs doivent effectuer une autre action pour mener à bien le SetupIntent. Utilisez l’objet next_action.cashapp_handle_redirect_or_display_qr_code de la réponse du SetupIntent pour rediriger vos utilisateurs vers une page hébergée Stripe qui affiche le code QR, ou présentez-leur directement le code QR.

Pour authentifier les utilisateurs, suivez les instructions pour confirmer un SetupIntent et enregistrer un moyen de paiement. Une fois les utilisateurs authentifiés, l’application mobile Cash App les redirige vers l’URL return_url de leur appareil mobile et le SetupIntent passe à l’état succeeded.

Créez un abonnement avec un tarif et un client. Définissez la valeur du paramètre default_payment_method sur l’ID de PaymentMethod contenu dans la réponse SetupIntent.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{PRICE_ID}} \
  -d default_payment_method={{PAYMENT_METHOD_ID}}

La réponse inclut le premier PaymentIntent de l’abonnement, qui contient une clé secrète à utiliser côté client pour finaliser le processus de paiement en toute sécurité, plutôt que de transmettre l’objet PaymentIntent dans son intégralité. Renvoyez le paramètre client_secret au front-end pour finaliser le paiement.