Plateformes Connect utilisant l'API SourcesObsolète

Considérations pour les plateformes Stripe Connect ajoutant la prise en charge de nouveaux moyens de paiement à l'aide de l'API Sources.

Alerte

We deprecated the Sources API and plan to remove support for local payment methods. If you currently handle any local payment methods using the Sources API, you must migrate them to the Payment Methods API.

While we don’t plan to remove support for card payments, we recommend replacing any use of the Sources API with the PaymentMethods API, which provides access to our latest features and payment method types.

Les propriétaires de la plateforme Connect peuvent utiliser des moyens de paiement supplémentaires pris en charge par Sources. Pour en savoir plus sur la création de paiements pour les utilisateurs connectés et sur l’approche qui vous convient le mieux, consultez notre documentation sur les paiements et frais Connect.

Créer des paiements indirects

Si vous choisissez les paiements indirects, vous devez créer des sources directement sur votre plateforme et créer des paiements à l’aide du paramètre de destination approprié. Les clients sont facturés par votre plateforme, qui ensuite transmet le montant nécessaire au compte de destination.

Pour les paiements indirects qui utilisent les cartes, le nom de votre plateforme apparaît sur les libellés de relevé de compte et le paiement est attribué au compte connecté. Pour les paiements indirects qui utilisent des moyens de paiement alternatifs (APM), le nom de votre plateforme apparaît sur les libellés de relevé de compte mais le paiement est attribué à votre plateforme.

Créer des paiements directs

Si vous choisissez des paiements directs, vous devrez vous assurer que le compte connecté est intégré au moyen de paiement que vous avez l’intention d’utiliser (voir ci-dessous). Les paiements directs exigent de créer des sources sur les comptes connectés. Vous pouvez le faire en passant source.stripeAccount avec une valeur pour l’identifiant d’un compte connecté lorsque vous utilisez Stripe.js.

// Set the connected Stripe Account on which the source should be created
var stripe = Stripe(
  'pk_test_TYooMQauvdEDq54NiTphI7jx'
,
  {stripeAccount: "{{CONNECTED_STRIPE_ACCOUNT_ID}}"},
);

stripe.createSource({
  type: 'ideal',
  amount: 1099,
  currency: 'eur',
  owner: {
    name: 'Jenny Rosen',
  },
  redirect: {
    return_url: 'https://shop.example.com/crtA6B28E1',
  },
}).then(function(result) {
  // handle result.error or result.source
});

Si vous créez des sources côté serveur, vous pouvez utiliser l’authentification utilisant l’en-tête du compte Stripe avec toutes les bibliothèques que nous prenons en charge.

Dupliquer les sources de carte

Les sources de carte (car elles ne sont pas intrinsèquement liées à votre plateforme puisqu’elles n’exigent aucun flux d’authentification) peuvent être créées sur votre plateforme, puis dupliquées dans un compte connecté pour y créer des paiements directs.

Une fois que vous avez créé une source de carte et que vous l’avez rattachée à un Client (voir notre guide Sources et clients pour des informations supplémentaires sur l’interaction entre les deux objets), vous pouvez dupliquer cette source de carte sur un compte connecté en utilisant l’identifiant de ce compte comme titre de compte Stripe, Stripe-Account :

Les sources de carte sont généralement reusable (réutilisables). Cependant, lorsque vous en faites une copie, vous pouvez modifier cette propriété pour limiter la façon dont le compte connecté l’utilise en ajustant simplement le paramètre usage sur single_use (usage unique) lors de la duplication de la source.

Si vous créez des sources de carte réutilisables sur votre compte connecté, vous devez veiller à les rattacher aux clients avant de les débiter (voir notre guide Sources et clients pour des informations supplémentaires sur le rattachement des sources aux clients et leur gestion).