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. Go to the Products page and click Create product.
2. Saisissez un Nom pour le produit. Vous pouvez éventuellement ajouter une Description et télécharger une image du produit.
3. Select a Product tax code. Learn more about product tax codes.
4. Sélectionnez Récurrent. Saisissez ensuite pour le prix et sélectionnez comme devise.
5. Choose whether to Include tax in price. You can either use the default value from your tax settings or set the value manually. In this example, select Auto.
6. Pour Période de facturation, sélectionnez Mensuel.
7. Click More pricing options. Then select Flat rate as the pricing model for this example. Learn more about flat rate and other pricing models.
8. Add an internal Price description and Lookup key to organize, query, and update specific prices in the future.
9. Cliquez sur Suivant. Cliquez ensuite sur Ajouter un 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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.