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.

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 available pour déterminer si un client voit s’afficher un moyen de paiement donné au moment du paiement. Si available est défini sur true, la fonctionnalité de ce moyen de paiement est active et display_preference est activé. Si available est défini sur false, soit la fonctionnalité n’est pas active, soit la valeur display_preference est désactivée, et les clients ne la verront pas au moment du paiement. Pour simplifier votre intégration et tirer parti d’autres fonctionnalités, utilisez les moyens de paiement gérés depuis le Dashboard. Le paramètre sera alors lu automatiquement, et les bons moyens de paiement seront proposés au client lors du paiement.
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.