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 abonnement avec un tarif et un client à l’état incomplete en attribuant au paramètre payment_behavior la valeur default_incomplete. Définissez le paramètre payment_settings.save_default_payment_method=on_subscription pour enregistrer un moyen de paiement lors de l’activation de l’abonnement.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d payment_behavior=default_incomplete \
  -d "items[0][price]"={{PRICE_ID}} \
  -d "payment_settings[save_default_payment_method]"=on_subscription \
  -d "expand[0]"="latest_invoice.payments" \
  -d "expand[1]"="latest_invoice.confirmation_secret"

La réponse inclut la première facture de l’abonnement. Celui-ci contient les paiements de la facture, qui inclut un PaymentIntent par défaut que Stripe a généré pour cette facture et la clé secrète de confirmation que vous pouvez envoyer au client afin qu’il finalise le processus de paiement en toute sécurité au lieu de lui transmettre la totalité de l’objet PaymentIntent. Renvoyez le latest_invoice.confirmation_secret.client_secret au front-end pour finaliser le paiement.

Obtenez l’ID PaymentIntent que vous devez utiliser pour confirmer un paiement provenant de latest_invoice.payments.

Confirmez un paiement avec l’API PaymentIntents à l’aide de l’ID de PaymentIntent contenu dans la réponse de l’objet Subscriptions.

Ajoutez l’ID de PaymentIntent au chemin de l’URL et définissez la valeur du paramètre payment_method_types sur cashapp.

curl https://api.stripe.com/v1/payment_intents/:id/confirm \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_data[type]"=cashapp \
  --data-urlencode return_url="https://www.stripe.com" \
  -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 \
  -d "mandate_data[customer_acceptance][accepted_at]"=1660000000

La réponse du PaymentIntent contient l’état requires_action, ce qui signifie que vos utilisateurs doivent effectuer une autre action pour mener à bien le PaymentIntent. Utilisez l’objet next_action.cashapp_handle_redirect_or_display_qr_code de la réponse du PaymentIntent pour rediriger vos utilisateurs vers une page hébergée Stripe qui affiche le code QR, ou présentez-leur directement le code QR. Afin d’authentifier les utilisateurs, suivez les instructions pour rediriger les utilisateurs et authentifier les transactions. Après leur authentification, l’application mobile Cash App redirige les utilisateurs vers l’URL return_url de leur appareil mobile et le PaymentIntent passe à l’état succeeded.

Une fois le paiement abouti, l’abonnement devient actif et le moyen de paiement est enregistré comme moyen de paiement par défaut.