Paiements par carte sur l'API ChargesAncien

Les API Charges et Tokens sont d’anciennes API utilisées dans de vieilles intégrations Stripe afin 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 des fonctionnalités de Stripe. Pour bénéficier des fonctionnalités plus récentes, utilisez Stripe Checkout ou migrez vers l’API Payment Intents.

Tunnel 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 via 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 centime (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é bancaire dynamique

Par défaut, le libellé de relevé bancaire de votre compte Stripe apparaît sur les relevés de vos clients chaque fois que vous débitez leur carte. Vous pouvez également définir le 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é bancaire sont limités à 22 caractères, ne peuvent pas contenir les caractères spéciaux <, >, ', " ou *, et ne doivent pas être constitués uniquement de chiffres.

Lorsque vous définissez un libellé de relevé bancaire dynamique sur des paiements par carte bancaire, la partie dynamique du libellé est accolée au libellé indiquant le marchand du règlement (séparés par le signe * puis une espace). Par exemple, un libellé de relevé bancaire d’une entreprise nommée FreeCookies qui inclurait le type de cookie 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é bancaire 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 dus à la limite de caractères, vous pouvez définir un libellé de relevé bancaire abrégé dans votre Dashboard Stripe afin de raccourcir le libellé de l’entité de règlement. Vous aurez ainsi plus de place pour le libellé dynamique. Le libellé abrégé :

• Remplace le libellé de relevé bancaire de l’entité de règlement en présence d’un libellé de relevé bancaire 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, notamment au traitement des paiements. Les métadonnées ne sont pas visibles pour vos clients et n’influent aucunement sur un éventuel refus de paiement ou un blocage 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 en tant que métadonnées. De cette façon, vous pouvez définir des règles Radar basées sur des 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.

• En gérant l’erreur d’API 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 inclut l’ID du paiement. Vous pouvez vous en servir pour récupérer le paiement.
• En utilisant les webhooks pour suivre les mises à jour d’état. Par exemple, l’événement charge.failed se déclenche lorsqu’un paiement échoue.