Configurations multiples pour vos comptes Connect

Comment permettre à vos comptes connectés de proposer différents ensembles de moyens de paiement à leurs clients dans différents scénarios.

Utilisez cette fonctionnalité si votre plateforme utilise des moyens de paiement dynamiques et prend en charge la configuration de différents types de moyens de paiement pour différents types de transactions (par exemple, abonnements ou paiements ponctuels) ou pour différents montants de facture (par exemple, les factures supérieures à un certain montant peuvent être réglées avec un moyen de paiement différé).

Créer une configuration de moyens de paiement
Dashboard

Accédez aux paramètres des moyens de paiement de vos comptes connectés sur le Dashboard Stripe. C’est ici que vous contrôlez les configurations « parentes » au niveau de votre plateforme. Vos comptes connectés reçoivent pour chaque parent une configuration « enfant » personnalisable dans le cadre des contraintes que vous avez définies ci-dessous.

Au départ, vous disposez d’une configuration parente par défaut. Pour créer une configuration supplémentaire, cliquez sur Ajouter une nouvelle configuration, puis donnez-lui un nom.

Pour vous assurer que la configuration du moyen de paiement que vous souhaitez activer est définie sur active dans le Dashboard :

Passez aux paramètres de vos moyens de paiements.
Cliquez sur un moyen de paiement dans la section Configurations des paiements, puis cliquez sur le menu débordant () > Gestion de la configuration.
Sous État de la configuration, activez l’option Active.
Cliquez sur Enregistrer les modifications pour appliquer vos mises à jour.

Page de configuration des moyens de paiement

Définir l'état par défaut de chaque moyen de paiement
Dashboard

Vous pouvez appliquer le paramètre par défaut de chaque moyen de paiement à votre nouvelle configuration parente et contrôler les personnalisations que vos comptes connectés peuvent apporter. Utilisez la liste déroulante pour sélectionner le paramètre souhaité :

Activé par défaut active le moyen de paiement par défaut. Les comptes connectés peuvent l’activer et le désactiver à leur guise.
Désactivé par défaut désactive le moyen de paiement par défaut. Les comptes connectés peuvent l’activer et le désactiver à leur guise.
Bloqué désactive le moyen de paiement pour tous les comptes connectés. Les comptes connectés ne peuvent pas l’activer, mais la plateforme peut remplacer cette option pour chaque compte connecté.

Configurer les paramètres de chaque moyen de paiement

Autorisez vos comptes connectés à personnaliser leurs moyens de paiement

Les comptes connectés ayant accès au Dashboard Stripe complet peuvent activer ou désactiver les moyens de paiement définis sur On by default ou Off by default. Vos comptes connectés ont accès à la nouvelle configuration enfant créée dans leurs paramètres des moyens de paiement. Vos comptes connectés peuvent utiliser le menu déroulant en haut de la page pour choisir une configuration à modifier.

Si vous souhaitez que vos comptes connectés puissent personnaliser les paramètres de leurs moyens de paiement à partir du Dashboard de votre plateforme plutôt que du Dashboard Stripe, ou si certains de vos comptes connectés n’ont pas accès au Dashboard Stripe, vous pouvez intégrer l’API Payment Method Configurations.

Utilisez l’API Payment Method Configurations avec l’ID d’un compte connecté et l’ID de la configuration enfant pour consulter l’état actuel d’un moyen de paiement pour un compte connecté donné sur cette configuration.

{
  "object": "list",
  "data": [
    {
      "id": "{{PAYMENT_METHOD_CONFIGURATION_ID}}"
,
      "object": "payment_method_configuration",
      "name": "My Custom Configuration",
      "active": true,
      "is_default": true,
      "livemode": false,
      "parent": "{{PAYMENT_METHOD_CONFIGURATION_ID}}"
,
      "acss_debit": {
        "available": false,
        "display_preference": {
          "overridable": true,
          "preference": "off",
          "value": "off"
        }
      },
      "affirm": {
        "available": false,
        "display_preference": {
          "overridable": true,
          "preference": "off",
          "value": "off"
        }
      },
      "afterpay_clearpay": {
        "available": false,
        "display_preference": {
          "overridable": true,
          "preference": "off",
          "value": "off"
        }
      },
      ... additional payment methods
    }
  ],
  "has_more": false,
  "url": "/v1/payment_method_configurations"
}

Si l’opération réussit, la liste renvoyée affiche chaque moyen de paiement avec deux paramètres précisant la disponibilité et les préférences d’affichage.

available est la combinaison des valeurs de fonctionnalité (active, inactive, pending ou unrequested) et de display_preference.
Vous pouvez utiliser le champ disponible pour déterminer si un client voit ce moyen de paiement lors du Checkout. Si disponible est vrai, la fonctionnalité du moyen de paiement est active et display_preference est activé. Si disponible est faux, soit la fonctionnalité du moyen de paiement n’est pas active, soit la valeur display_preference est désactivée, ce qui signifie que les clients ne verront pas ce moyen de paiement au moment du paiement.
Pour simplifier votre intégration et profiter d’autres fonctionnalités, utilisez des moyens de paiement que vous gérez depuis le Dashboard au moment du paiement. Ainsi, ils lisent automatiquement ce paramètre et affichent les moyens de paiement appropriés aux clients.
display_preference comporte trois éléments : overridable, preference et value.
- overridable indique si la préférence du compte connecté doit remplacer celle par défaut ci-dessus. Ce paramètre n’est pas modifiable.
- preference, disponible en écriture, contient la préférence du compte connecté.
- value affiche la valeur effective de display_preference. Ce paramètre n’est pas modifiable.

Remarque

Seuls les moyens de paiement pertinents au regard du pays du compte connecté s’affichent dans la réponse de l’API et peuvent être configurés. Consulter les pays pris en charge.

Lorsqu’un compte connecté active ou désactive un moyen de paiement, vous pouvez mettre à jour l’attribut preference de display_preference. Celui-ci enregistre la préférence du propriétaire du compte connecté pour ce moyen de paiement et sert à déterminer si les acheteurs voient ce moyen de paiement.

{
  "id": "{{PAYMENT_METHOD_CONFIGURATION_ID}}"
,
  "object": "payment_method_configuration",
  "name": "My Custom Configuration",
  "active": true,
  "is_default": true,
  "livemode": false,
  "acss_debit": {
    "available": false,
    "display_preference": {
      "overridable": true,
      "preference": "off",
      "value": "off"
    }
  },
  "affirm": {
    "available": true,
    "display_preference": {
      "overridable": true,
      "preference": "on",
      "value": "on"
    }
  },
  "afterpay_clearpay": {
    "available": false,
    "display_preference": {
      "overridable": true,
      "preference": "off",
      "value": "off"
    }
  },
  ... additional payment methods
}

Lorsque vos comptes connectés activent des moyens de paiement via l’API, Stripe classe de manière intelligente les moyens de paiement en fonction de l’emplacement de l’acheteur, de la taille de la commande et d’autres facteurs, afin de toujours afficher en premier les moyens de paiement offrant les meilleurs taux de conversion.

Utiliser la configuration dans votre tunnel de paiement

Lors du rendu de votre tunnel de paiement, transmettez l’ID de la configuration parente pour utiliser votre nouvelle configuration. Stripe recherche automatiquement la configuration enfant du compte connecté associé et utilise ses paramètres personnalisés.

FacultatifApple Pay et Google Pay

Apple Pay et Google Pay sont pas considérés comme étant des types de moyens de paiement distincts sur un PaymentIntent et ne peuvent être confirmés qu’au moyen de la carte bancaire. Avec l’API Payment Method Configurations, vous pouvez laisser aux propriétaires de comptes connectés le choix d’utiliser ou non ces moyens de paiement spécifiques, et vous pouvez empêcher qu’ils n’apparaissent dans l’interface utilisateur. L’activation d’Apple Pay et de Google Pay nécessite que la carte soit activée.