Paiements par carte sur l'API ChargesAncien

Les API Charges et Tokens sont d’anciennes API utilisées dans de vieilles intégrations Stripe qui permettent d’accepter les paiements par carte de crédit et de débit. Utilisez PaymentIntents pour effectuer de nouvelles intégrations.

L’API Charges limite votre capacité à profiter pleinement des fonctionnalités de Stripe. Pour bénéficier des dernières fonctionnalités, utilisez Stripe Checkout ou migrez vers l’API Payment Intents.

Flux de paiement

Dans la plupart des cas, l’API Payment Intents offre plus de flexibilité et d’options d’intégration.

Remboursements

Pour rembourser un paiement au moyen de l’API, créez un remboursement et indiquez l’ID du paiement à rembourser.

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d charge={{CHARGE_ID}}

Pour effectuer un remboursement partiel, saisissez un paramètre amount, qui devra être un nombre entier exprimé en cents (ou dans la plus petite unité de la devise du paiement).

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d charge={{CHARGE_ID}} \
  -d amount=1000

Apple Pay

Lorsque votre client approuve un paiement, votre application implémente les méthodes PKPaymentAuthorizationViewControllerDelegate pour recevoir une instance de PKPayment contenant les informations de carte cryptées de votre client.

1. Utilisez la méthode SDK createTokenWithPayment pour transformer le PKPayment en Token Stripe
2. Utilisez ensuite ce Token pour créer un paiement.

extension CheckoutViewController: PKPaymentAuthorizationViewControllerDelegate {

    func paymentAuthorizationViewController(_ controller: PKPaymentAuthorizationViewController, didAuthorizePayment payment: PKPayment, handler: @escaping (PKPaymentAuthorizationResult) -> Void) {
        // Convert the PKPayment into a Token
        STPAPIClient.shared.createToken(withPayment: payment) { token, error in
              guard let token = token else {
                  // Handle the error
                  return
              }
            let tokenID = token.tokenId
            // Send the token identifier to your server to create a Charge...
            // If the server responds successfully, set self.paymentSucceeded to YES
        }
    }

    func paymentAuthorizationViewControllerDidFinish(_ controller: PKPaymentAuthorizationViewController) {

Libellé de relevé de compte dynamique

Le libellé de relevé de votre compte Stripe figure par défaut sur les relevés de vos clients chaque fois que vous débitez leur carte. Vous pouvez également définir un libellé de manière dynamique pour toute requête de paiement à l’aide de l’argument statement_descriptor sur l’objet Charge.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=999 \
  -d "currency"="usd" \
  -d "description"="Example charge" \
  -d "source"="tok_visa" \
  -d "statement_descriptor"="Custom descriptor"

Les libellés de relevé de compte ne peuvent dépasser 22 caractères. Ils ne peuvent pas contenir les caractères spéciaux <, >, ', " ou *, et ne doivent pas être compris uniquement de chiffres.

Lorsque vous définissez un libellé de relevé de compte dynamique sur des paiements par carte de débit et de crédit, la partie dynamique du libellé est accolée au libellé indiquant l’entité de règlement (séparés par le signe * puis une espace). Par exemple, un libellé de relevé de compte d’une entreprise nommée FreeCookies qui inclurait le type de biscuit acheté pourra être : FREECOOKIES* SUGAR.

Le signe * et l’espace sont inclus dans la limite de 22 caractères. Par ailleurs, Stripe alloue automatiquement 10 caractères au libellé de relevé de compte dynamique. Par conséquent, si le libellé de l’entité de règlement dépasse 10 caractères et que le libellé dynamique fait également 10 caractères ou plus, le libellé de l’entité de règlement sera tronqué. Si le libellé dynamique dépasse 10 caractères, alors les deux libellés seront tronqués au niveau du 10ème caractère.

Si vous rencontrez des problèmes liés à la limite de caractères, vous pouvez définir un libellé abrégé dans votre Dashboard Stripe afin de raccourcir le libellé du relevé de compte de l’entité de règlement. Vous aurez plus de place pour le libellé dynamique. Le libellé abrégé :

• Remplace le libellé de relevé de compte de l’entité de règlement en présence d’un libellé de relevé de compte dynamique.
• Doit comporter entre 2 et 10 caractères.

Si vous ne savez pas à quoi ressemblent vos libellés lorsqu’ils sont accolés, vous pouvez le vérifier dans le Dashboard Stripe.

Stockage d’informations sous forme de métadonnées

Stripe vous permet d’ajouter des métadonnées à vos requêtes les plus courantes, comme le traitement des paiements. Les métadonnées ne sont pas visibles pour vos clients et ne sont pas prises en compte pour déterminer si un paiement est refusé ou bloqué par notre système de prévention des fraudes.

Les métadonnées vous permettent d’associer d’autres informations, pertinentes pour vous, aux données d’activité Stripe. Toutes les métadonnées que vous incluez sont visibles dans le Dashboard (par exemple sur la page d’un paiement donné) ainsi que dans de nombreux rapports et exports. Par exemple, vous pouvez associer l’ID attribué à la commande par votre boutique au paiement effectué en règlement de celle-ci. Pour votre comptable ou votre service financier, le rapprochement des paiements sur Stripe et des commandes enregistrées sur votre système interne s’en trouvera grandement facilité.

Si vous utilisez Radar, il peut être judicieux de transmettre toutes les informations supplémentaires concernant vos clients et leurs commandes comme métadonnées. De cette façon, vous pouvez définir des règles Radar en fonction d’attributs de métadonnées et disposer de davantage d’informations sur les paiements dans le Dashboard, ce qui peut accélérer votre processus d’examen.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=999 \
  -d "currency"="usd" \
  -d "description"="Example charge" \
  -d "source"="tok_visa" \
  -d "metadata[order_id]"=6735

Refus de paiement

Si vous souhaitez que votre intégration réponde automatiquement aux échecs de paiement, vous pouvez accéder au paramètre outcome d’un paiement de deux manières différentes.

• Il faut gérer l’erreur d’API qui est renvoyée lors de l’échec d’un paiement. Pour les paiements refusés par l’émetteur de cartes et les paiements bloqués, l’erreur comprend l’ID du paiement. Vous pouvez vous en servir pour récupérer le paiement.
• Utilisez les webhooks pour effectuer le suivi des mises à jour de l’état des paiements. Par exemple, l’événement charge.failed se déclenche lorsqu’un paiement échoue.