Migrer des comptes vers Stripe

Stripe vous permet de migrer vos comptes connectés existants ainsi que vos données de paiement et de clientèle. Cela vous permet de continuer à encaisser les paiements et les virements ou de permettre à d’autres entreprises d’accepter directement des paiements. Pour intégrer avec succès votre activité de plateforme existante sur Stripe, vous devez :

1. Créer un plan et un calendrier de migration
2. Mettre à jour votre intégration pour vos comptes connectés
3. Créer et inscrire des comptes
4. Gérer les exigences en attente et en cours
5. Migrer les données de paiement et client vers Stripe

Créer un plan de migration

Une migration réussie vers Stripe inclut un plan de migration, un calendrier et des informations KYC pour les comptes connectés, ainsi que des données de paiement et client.

Les comptes connectés doivent s’inscrire à Stripe, ce qui nécessite l’envoi de données Stripe Know Your Customer (KYC) de chaque compte. Les exigences de Stripe peuvent nécessiter la collecte d’informations supplémentaires auprès de vos comptes. Effectuez une analyse pour comprendre quelles données ont été collectées auprès de votre ancien fournisseur et de quelles données Stripe a besoin. Stripe vérifie les données KYC avant d’activer les comptes connectés. Surveillez l’état de vérification des comptes à l’aide de l’événement account.updated ou de l’API Retrieve Account. En cas d’échec de la vérification, une action est requise pour que les comptes puissent être activés.

Indiquez une date de transition définitive pour les données de paiement après l’inscription des comptes à Stripe. Les données de paiement et client nécessitent une importation de numéro PAN dans le cadre de la transition. Nous vous recommandons d’importer les comptes par lots.

Mettre à jour votre intégration

Votre application peut nécessiter des modifications dans le cadre des mises à jour de l’intégration pour migrer vers Stripe. Par exemple, envisagez toute modification de l’utilisation de votre plateforme par vos comptes connectés, telle que la mise à jour des tarifs. Stripe vous recommande de communiquer à l’avance toute modification apportée à vos comptes.

Conditions d’utilisation du service Stripe

Pour pouvoir être activés, vos comptes connectés doivent accepter les Conditions d’utilisation du service Stripe.

Les comptes dont Stripe est responsable de la collecte des informations mises à jour lorsque certaines exigences sont requises ou modifiées (y compris les comptes Standard et Express) acceptent les Conditions d’utilisation du service Stripe dans le cadre du flux d’inscription.

Si votre plateforme est responsable de la collecte des informations mises à jour d’un compte connecté (y compris les comptes Custom) lorsque les exigences viennent à évoluer, vous pouvez inclure les Conditions d’utilisation du service Stripe dans vos propres conditions d’utilisation. Nous vous recommandons de placer la case d’acceptation des conditions d’utilisation du service à la fin du flux d’inscription, mais vous pouvez également la placer au début pour l’adapter à votre entreprise. Lors de la création ou de la mise à jour des comptes connectés, enregistrez l’acceptation de vos clients des Conditions d’utilisation du service actualisées pour l’envoyer à Stripe, puis communiquez ces informations aux comptes.

Inscrire des comptes connectés à Stripe

Stripe propose différents niveaux de support pour l’inscription de vos comptes connectés. Créez un flux d’inscription pour vos comptes connectés à l’aide de l’une des méthodes suivantes :

Créer et inscrire des comptes

Voici un aperçu du processus :

Définir les exigences du compte

Les facteurs suivants affectent les exigences d’inscription pour vos comptes connectés :

• Pays d’origine des comptes connectés
• Le type de contrat de service applicable aux comptes connectés
• Fonctionnalités demandées pour les comptes connectés
• Le business_type (par exemple, particulier ou entreprise) et la structure de l’entreprise (par exemple, public_corporation ou private_partnership)

Utilisez le formulaire interactif pour voir comment la modification de ces facteurs affecte les exigences.

Créer le compte connecté

Pour chaque compte à migrer vers Stripe, créez un compte associé.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "controller[fees][payer]"=account \
  -d "controller[losses][payments]"=stripe \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[requirement_collection]"=stripe \
  -d country=US \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true

{
  ...
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  ...
}

{
  ...
  "requirements": {
    "alternatives": [],
    "current_deadline": null,
    "currently_due": [
      "business_profile.url",
      "external_account",
      "individual.first_name",
      "individual.last_name",
      "tos_acceptance.date",
      "tos_acceptance.ip"
    ],
    "disabled_reason": "requirements.past_due",
    "errors": [],

Gérer les exigences en attente et en cours

Lorsque les données du compte connecté sont soumises, Stripe les vérifie. Ce processus peut prendre quelques minutes ou quelques heures, selon la nature de la vérification. Au cours de ce processus, les fonctionnalités que vous avez demandées ont pour status pending.

État de la vérification

Vous pouvez récupérer l’état des fonctionnalités de votre compte connecté des manières suivantes :

• Examen du hash des fonctionnalités de l’objet Account pour la fonctionnalité concernée.
• Demandez des fonctionnalités directement à partir de l’API Capabilities et examinez l’état de la fonctionnalité concernée.
• Écoutez les événements account.updated dans votre endpoint de webhook et inspectez le hash capabilities pour la fonctionnalité correspondante.

Une fois les vérifications terminées, une fonctionnalité devient active et disponible pour le compte connecté. Les vérifications de compte s’exécutent en permanence, et si une vérification ultérieure échoue, une fonctionnalité peut ne plus être active . Écoutez les événements account.updated pour détecter les changements d’état des fonctionnalités.

Confirmez que votre intégration Connect est conforme et opérationnelle en vérifiant que les paramètres charges_enabled et payouts_enabled du compte sont tous deux définis sur « true ». Vous pouvez utiliser l’API ou écouter les événements account.updated. Pour plus d’informations sur les autres champs pertinents, vérifiez le hash des exigences du compte. Vous ne pouvez pas confirmer l’intégration sur la base d’une seule valeur, car les états peuvent varier selon l’application et les politiques associées.

• charges_enabled confirme que votre chemin de paiement complet (paiement et transfert) fonctionne correctement et détermine si les fonctions card_payments et transfers sont actives.
• payouts_enabled détermine si votre compte connecté peut effectuer des virements vers un compte externe. En fonction de vos politiques en matière de risques, vous pouvez autoriser votre compte connecté à commencer à effectuer des transactions sans avoir activé les virements. À terme, vous devrez activer les virements pour verser des fonds sur vos comptes connectés.

Vous pouvez partir de la logique suivante pour définir un état récapitulatif à afficher pour votre compte connecté.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

def account_state(account)
  reqs = account.requirements

  if reqs.disabled_reason && reqs.disabled_reason.include?("rejected")
    "rejected"
  elsif account.payouts_enabled && account.charges_enabled
    if reqs.pending_verification
      "pending enablement"
    elsif !reqs.disabled_reason && !reqs.currently_due
      if !reqs.eventually_due
        "complete"
      else
        "enabled"
      end
    else
      "restricted"
    end
  elsif !account.payouts_enabled && account.charges_enabled
    "restricted (payouts disabled)"
  elsif !account.charges_enabled && account.payouts_enabled
    "restricted (charges disabled)"
  elsif reqs.past_due
    "restricted (past due)"
  elsif reqs.pending_verification
    "pending (disabled)"
  else
    "restricted"
  end
end

accounts = Stripe::Account.list(limit: 10)

accounts.each do |account|
    puts "#{account.id} has state: #{account_state(account)}"
end

Gérer les erreurs de vérification

Gérez différemment les échecs de vérification selon votre flux d’inscription.

Migrer les données de paiement et client vers Stripe

Une fois vos comptes connectés créés sur Stripe, demandez une importation de données PAN, qui permet de migrer vos données de paiement et client pour les utiliser sur Stripe.