Intégration côté serveur

Pour mettre en place une intégration de back-end optimale, vous devez vous identifier auprès de Stripe, vous familiariser avec les bonnes pratiques en matière de requêtes à l’API et configurer vos webhooks de manière appropriée.

S’identifier sur Stripe

Stripe propose l’authentification au moyen d’une clé API. Vous pouvez également créer des clés d’accès limité pour mieux contrôler l’accès à des ressources spécifiques. Vous pouvez utiliser les clés API secrètes et publiques pour créer des tokens, mais vous avez besoin de clés secrètes pour toute authentification côté serveur.

Voici un exemple d’appel à l’API :

curl https://api.stripe.com/v1/balance \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Bonnes pratiques en matière de requêtes d’API

Stripe recommande l’ajout d’une clé d’idempotence à toutes les requêtes POST. Assurez-vous que la clé est unique. Il peut par exemple s’agir d’un identifiant unique universel ou d’une combinaison d’ID de clients et d’ID de commande. Ces clés vous permettent de relancer en toute sécurité des requêtes en cas d’erreur de réseau.

Objets Customer : enregistrer les informations de paiement

Pour stocker et réutiliser les PaymentMethods, vous devez les associer à des objets Customer.

Après avoir associé la PaymentMethod à un Customer, stockez l’ID du Customer et l’ID du PaymentMethod dans votre système pour l’utiliser pour les paiements futurs. Étant donné qu’un objet Customer peut avoir une liste de multiples moyens de paiement, vous devez spécifier à la fois l’ID du client et l’ID du PaymentMethod lorsque vous créez un paiement ultérieur.

Voici un exemple de création d’un objet Customer associé à un PaymentMethod :

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Jenny Rosen" \
  --data-urlencode email="jenny.rosen@stripe.com" \
  -d payment_method={PAYMENT_METHOD_ID}

Remboursements

Les remboursements sont gérés avec l’API Refunds et peuvent être complets ou partiels. Pour rembourser une transaction avec Stripe, vous aurez besoin de l’ID du PaymentIntent ou de l’ID du paiement correspondant à la transaction que vous souhaitez rembourser.

Les remboursements utilisent votre solde Stripe disponible et ne peuvent pas utiliser votre solde en cours. Si votre solde disponible n’a pas de fonds suffisants pour couvrir le montant du remboursement, Stripe débitera le montant restant de votre compte bancaire. Vous pouvez émettre des remboursements partiels, des remboursements complets et plus d’un remboursement pour un paiement, mais vous ne pouvez pas rembourser un total supérieur au moment du paiement original.

Vous pouvez émettre des remboursements en utilisant l’API ou le Dashboard. Une fois émis, vous ne pouvez plus supprimer un remboursement. Il apparaît sur le relevé du client sous 5 à 10 jours ouvrables. Si un client s’interroge sur l’état de son remboursement, vous pouvez lui fournir l’ARN pour qu’il puisse formuler une demande auprès de sa banque concernant le remboursement.

Voici un exemple de remboursement d’un PaymentIntent :

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent={PAYMENT_INTENT_ID}

Voici un exemple de remboursement partiel avec un montant spécifié :

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent={PAYMENT_INTENT_ID} \
  -d amount=1000

Litiges et contestations de paiement

Votre entreprise est responsable de la gestion des litiges (également appelés contestations de paiement). Nous vous recommandons de surveiller activement les litiges, de recueillir et de soumettre des preuves pour attester du bien-fondé des paiements, le cas échéant. Dans l’attente d’une décision, nous bloquons les fonds contestés et les déduisons de votre solde Stripe. Nous vous restituons les fonds si vous remportez le litige.

Vous pouvez surveiller les litiges de deux manières :

• Utilisez le Dashboard Stripe et les notifications par e-mail que vous pouvez configurer dans vos paramètres Informations personnelles.
• En cas de litige, vous pouvez pleinement automatiser la réponse et la soumission des preuves via l’API Disputes.

Configurer des webhooks

Vous pouvez utiliser des webhooks pour capturer les événements qui se produisent sur votre compte (notamment les versements réalisés sur votre compte bancaire, les remboursements, les paiements, etc.). Les webhooks sont utiles pour gérer les événements Stripe qui ont lieu de manière asynchrone, ou ceux pour lesquels vous souhaitez déclencher des actions supplémentaires.

Voir le webhook que nous recommandons pour chaque type :

Utilisez les ressources suivantes pour mettre en place vos webhooks et vous assurer qu’ils ont été configurés correctement :

• Webhooks
• Vérifier les signatures des webhooks
• Types d’événements
• Bonnes pratiques en matière d’utilisation des webhooks
• Vérifier la configuration de vos webhooks