Autorisation partielle

Découvrez comment autoriser des paiements partiels sur les transactions par carte.

Utilisez les autorisations partielles pour faire autoriser une partie du montant de la requête initiale d’une transaction par carte lorsque le solde disponible ne permet pas de couvrir la totalité du montant. Cela permet à vos clients d’utiliser le solde disponible sur leur carte (par exemple sur une carte de débit), et de régler la différence avec un autre moyen de paiement.

Avant de commencer

Tout d’abord, décidez de la manière dont vous souhaitez traiter la partie du montant correspondant à la requête initiale qui n’est pas couverte par l’autorisation partielle. Vous pouvez créer un PaymentIntent distinct pour un autre moyen de paiement, annuler le PaymentIntent dans son intégralité ou capturer uniquement le montant partiellement autorisé. Assurez-vous de communiquer clairement avec votre client sur la façon dont vous procédez pour la transaction et sur tout impact potentiel pour lui.

Conformité

Lorsque vous utilisez l’autorisation partielle, vous êtes responsable du respect de l’ensemble des lois, réglementations et règles de réseau en vigueur. Consultez les règles des réseaux de cartes bancaires avec lesquels vous souhaitez utiliser cette fonctionnalité pour vous assurer que vos ventes sont conformes à toutes les règles applicables, qui varient d’un réseau à l’autre. Par exemple, à partir de mai 2024, American Express réserve l’utilisation de la fonctionnalité aux cartes de débit et aux cartes prépayées et n’autorise pas cette utilisation pour des transactions récurrentes ou transfrontalières, tandis que Visa exige que vous utilisiez la fonctionnalité pour tous les types de cartes. Les informations fournies sur cette page traitant de votre conformité à ces exigences le sont uniquement à titre indicatif, et ne constituent en rien des conseils juridiques, fiscaux, comptables ou autres. Si vous ne savez pas quelles obligations vous devez respecter, consultez un professionnel.

Disponibilité

Fonctionnalité IC+

Vous pouvez accéder aux autorisations partielles avec la tarification IC+. Pour activer cette fonctionnalité, contactez votre représentant commercial ou le service d’assistance.

Les autorisations partielles présentent les restrictions suivantes :

Vous pouvez uniquement utiliser les autorisations partielles pour les paiements en ligne par carte bancaire.
Seuls Visa, Mastercard, Discover et Amex prennent en charge les autorisations partielles.
L’émetteur et le type de carte déterminent si elles sont pris en charge.
En raison de restrictions de réseau, vous ne pouvez pas capturer davantage que le montant autorisé en utilisant la surcapture si le montant d’une transaction a été partiellement autorisé.
Si vous traitez des paiements au nom de votre compte Connect à l’aide d’un atttribut transfer_amount, Stripe le limite au montant partiellement autorisé lorsque le transfer_amount est supérieur au montant partiellement autorisé.
Stripe applique un montant minimum pour les paiements partiellement autorisés et refuse tout PaymentIntent qui n’atteint pas ce montant.

Utiliser la capture manuelle pour créer et confirmer des PaymentIntents

Pour activer l’autorisation partielle pour certains PaymentIntents, définissez if_available sur le paramètre request_partial_authorization.

Vérifier l’état d’une autorisation partielle

Pour déterminer si les réseaux ont appliqué une autorisation partielle au paiement, examinez le champ payment_method_details de l’attribut latest_charge figurant dans la réponse de confirmation du PaymentIntent :

partial_authorization.status : Affiche l’un des états d’autorisation suivants : partially_authorized, fully_authorized, declined ou not_requested.
amount_requested : Confirme le montant initialement spécifié dans la requête.
amount_authorized : Détermine le montant autorisé.

L’exemple de réponse ci-dessous montre que la transaction est partiellement autorisée pour 70 USD, soit un montant inférieur aux 100 USD demandés initialement.

Example PaymentIntent confirmation response
{
  "id": "pi_foo",
  "amount": 7000,
  "amount_capturable": 7000,
  "amount_received": 0,
  "capture_method": "manual",
  ...
  // if latest_charge is expanded
  "latest_charge": {
    "id": "ch_foo",
    "object": "charge",
    "amount": 7000,
    "captured": false,
    "payment_method_details": {
      "card": {
        "amount_authorized": 7000,
        "amount_requested": 10000,
        "partial_authorization": {
          "status": "partially_authorized",
        }
      }
    }
  },
  ...
  "status": "requires_capture"
}

Si l’émetteur de la carte refuse l’autorisation, la réponse renvoie une erreur card_declined.

Capturer le PaymentIntent partiellement autorisé

Vous pouvez capturer un PaymentIntent autorisé à concurrence du montant (amount ou amount_capturable) renvoyé dans la réponse de confirmation.

Une capture réussie renvoie l’objet PaymentIntent avec les champs mis à jour :

Successful capture response
{
  "id": "pi_foo",
  "amount": 7000,
  "amount_capturable": 0,
  "amount_received": 7000,
  "capture_method": "manual",
  "latest_charge": "ch_foo",
  ...
  "status": "succeeded",
}

FacultatifUtiliser la capture automatique pour confirmer et capturer un PaymentIntent

FacultatifCompléter avec une autorisation partielle

Tester votre intégration

Pour déclencher une autorisation partielle pendant les tests, utilisez la carte de test Stripe prévue pour les autorisations partielles avec n’importe quel CVC, code postal et date d’expiration postérieure à la date du jour. Veillez à définir request_partial_authorization sur if_available pour déclencher une autorisation partielle avec la carte de test.

Numéro de carte bancaire de test	Moyen de paiement	Description
	`pm_card_debit_partialAuthorization`	Cette carte autorise 70 % du montant indiqué dans la demande de confirmation, arrondi à l’unité inférieure (par exemple, le centime) avec une autorisation partielle demandée. Dans le cas contraire, il le refuse avec un code d’erreur pour fonds insuffisants.
	`pm_card_debit_partialIncrement`	Cette carte autorise entièrement l’autorisation initiale. Pour les compléments ultérieurs, cette carte autorise 70 % du montant indiqué dans la demande de complément, arrondi à l’unité inférieure (par exemple, le centime) avec une autorisation partielle demandée. Dans le cas contraire, le système renvoie des fonds insuffisants.