API Payment Method Configurations

Dans le Dashboard Stripe, définissez les moyens de paiement par défaut au niveau de la plateforme sur la page Gérer les moyens de paiement pour vos comptes connectés pour modifier les moyens de paiement activés par défaut.

Dans le Dashboard, cliquez sur l’icône en forme de roue dentée dans le coin supérieur droit pour ouvrir la page des Paramètres produit, puis cliquez sur le lien Moyens de paiement dans la section ** Paiements**.

En tant que plateforme, vous pouvez définir des préférences en matière de moyens de paiement pour votre plateforme et vos comptes connectés. Les paramètres de Votre compte s’appliquent à vos flux de paiements directs. Par exemple, si vous facturez des frais mensuels à vos utilisateurs pour l’utilisation de votre plateforme via votre propre page de paiement, utilisez les paramètres de Votre compte pour gérer ces paiements.

Les paramètres de Vos comptes connectés vous permettent de gérer les moyens de paiement que les comptes connectés sur votre plateforme peuvent accepter.

Pour définir l’état par défaut de tous les comptes connectés sur votre plateforme, cliquez sur le lien Modifier les paramètres sous Vos comptes connectés.

Pour chaque moyen de paiement, utilisez la liste déroulante pour sélectionner le paramètre souhaité :

• Les comptes connectés définis sur Désactivé par défaut peuvent activer ou désactiver le moyen de paiement à leur guise. Le moyen de paiement est désactivé par défaut.
• Le paramètre Bloqué désactive le moyen de paiement pour tous les comptes connectés. Les propriétaires des comptes connectés ne peuvent pas l’activer.
• Les comptes connectés définis sur Activé par défaut peuvent activer ou désactiver le moyen de paiement à leur guise. Le moyen de paiement est activé par défaut.

Utilisez l’API Payment Method Configurations avec l’ID d’un compte connecté pour consulter l’état actuel d’un moyen de paiement de ce compte connecté. Si le compte connecté a plusieurs configurations, vous pouvez filtrer les résultats en fonction du client_id de votre application, qui se trouve dans vos paramètres Connect.

curl -G https://api.stripe.com/v1/payment_method_configurations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d application=
{{CLIENT_APPLICATION_ID}}

{
  "object": "list",
  "data": [
    {
      "id": 
"{{PAYMENT_METHOD_CONFIGURATION_ID}}",
      "object": "payment_method_configuration",
      "name": "Default",
      "active": true,
      "is_default": true,
      "livemode": false,
      "application": 
"{{CLIENT_APPLICATION_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 un moyen de paiement donné s’afficher au moment du paiement. Si sa valeur est true, le moyen de paiement correspondant est actif et display_preference est activé. Si sa valeur est false, cela signifie que le moyen de paiement n’est pas activé ou que display_preference est désactivé, et que les clients ne verront pas ce moyen de paiement au moment du paiement. Pour simplifier votre intégration et tirer parti d’autres fonctionnalités, utilisez les moyens de paiement dynamiques. Le paramètre « available » est alors lu automatiquement, et les bons moyens de paiement sont proposés à l’acheteur lorsqu’il s’apprête à payer.

• 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.

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

curl https://api.stripe.com/v1/payment_method_configurations/
{{PAYMENT_METHOD_CONFIGURATION_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "affirm[display_preference][preference]"=on

{
  "id": 
"{{PAYMENT_METHOD_CONFIGURATION_ID}}",
  "object": "payment_method_configuration",
  "name": "Default",
  "active": true,
  "is_default": true,
  "livemode": false,
  "application": 
"{{CLIENT_APPLICATION_ID}}",
  "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
}

Vous pouvez gérer les moyens de paiement depuis le Dashboard. Stripe gère l’affichage des moyens de paiement admissibles en fonction de facteurs tels que le montant de la transaction, la devise et le tunnel de paiement. Ainsi, les clients ne verront s’afficher que les moyens de paiement pour lesquels available est défini sur true dans le tunnel de paiement.

Si vous souhaitez récupérer les moyens de paiement disponibles pour un compte connecté avant d’afficher votre page de paiement, appelez l’API Payment Method Configurations pour obtenir la liste des moyens de paiement. Utilisez ceux dont le paramètre available est défini sur true.

Certains moyens de paiement tels qu’Apple Pay ou Link ne 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 card. 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.

Utilisez des messages marketing ciblés pour inciter les propriétaires de comptes connectés à utiliser des moyens de paiement spécifiques auxquels ils sont admissibles mais qu’ils n’ont pas encore activés.

Appelez la méthode GET pour accéder à l’état de la configuration d’un moyen de paiement afin de savoir quand en faire la promotion auprès de vos comptes connectés. Pour savoir si le propriétaire d’un compte connecté a déjà modifié votre configuration, consultez la valeur display_preference. Si le paramètre preference de display_preference est none, le propriétaire du compte connecté n’a pas modifié la configuration par défaut. Si la valeur de preference est on ou off, le propriétaire du compte connecté a modifié la configuration ; vous pouvez alors choisir de supprimer ou non le message promotionnel.