Acheminer des paiements vers plusieurs prestatairesVersion bêta privée

Les règles énoncent les conditions et actions qui permettent d’acheminer les paiements vers un prestataire de paiement spécifique.

1. Si vous n’en avez pas encore, créez un environnement de test. Utilisez le bac à sable pour ajouter et tester des règles avant de passer en mode production.
2. Sur la page Orchestration du Dashboard, cliquez sur Ajouter des règles.
3. Ajoutez des règles avec une condition qui achemine le paiement vers l’un des prestataires disponibles lorsque Card country est égal à United Kingdom. Ajoutez une action pour acheminer le paiement vers Stripe si la condition n’est pas remplie.
4. [Facultatif] Ajoutez un processeur pour retenter le paiement une fois de plus si le paiement échoue sur le processeur principal.
5. Cliquez sur Activer les règles de test.

Lorsque vous créez un PaymentIntent, incluez le paramètre payments_orchestration pour activer Orchestration.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=500 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_visa \
  -d "payments_orchestration[enabled]"=true \
  -d confirm=true

L’orchestration ne prend pas en charge l’API Setup Intents ni les fonctionnalités d’acquisition flexible chez d’autres prestataires. Pour les transactions qui impliquent une demande 3D Secure, vous êtes responsable de fournir à Stripe le BIN de l’acquéreur qui correspond au prestataire vers lequel vous acheminez ces transactions. Vous pouvez contacter votre représentant Stripe pour savoir si Orchestration prend en charge les fonctionnalités que vous utilisez.

Utilisez des cartes de test pour vous assurer que Stripe achemine les paiements vers les prestataires spécifiés par vos règles. Par exemple, pour vérifier si les paiements sont acheminés vers le prestataire que vous avez sélectionné pour les paiements dans lesquels le pays de la carte est égal au Royaume-Uni, vous pouvez utiliser le moyen de paiement de test pm_card_gb :

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=12345 \
  -d currency=gbp \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_gb \
  -d "payments_orchestration[enabled]"=true \
  -d confirm=true

Après avoir créé un paiement test, consultez la page contenant les détails du paiement pour voir vers quel prestataire le paiement a été acheminé. Sur la page contenant les détails du paiement, vous trouverez le Prestataire sous Prestataire. La section Activité récente indique également le prestataire et les règles d’acheminement du paiement. Cliquez sur le lien pour afficher les règles qui ont acheminé ce paiement.

Le Payment Record contient l’historique d’exécution des paiements pour lesquels Orchestration est activée. Récupérez le Payment Record à l’aide de son ID dans le PaymentIntent.

curl https://api.stripe.com/v1/payment_records/{{PAYMENT_RECORD_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Vous pouvez également saisir l’ID de l’objet Payment Record dans l’inspecteur dans Workbench.

Vérifiez vers quel prestataire le paiement a été acheminé en consultant le hachage processor_details :

{
  "id": "pr_123456",
  "object": "payment_record",
  "amount_authorized": {
    "currency": "gbp",
    "value": 12345
  },
  ...
  "processor_details": {
    "type": "processor_a",
    ...
  },
  ...
}

Après avoir testé votre intégration, quittez votre environnement de test et ajoutez des règles pour votre intégration de production. Orchestration est actif dès que vous activez vos règles. Découvrez d’autres conditions et actions pour l’acheminement des paiements.

Surveiller les performances des prestataires

Après avoir activé Orchestration pour vos paiements réels, utilisez le Dashboard afin de surveiller les performances de vos prestataires.

• Sur la page de présentation d’Orchestration, accédez aux analyses de performance et aux taux de réussite des paiements de vos prestataires de paiement. Vous pouvez filtrer ces données pour consulter les performances par devise, marque de carte, pays de carte, type de carte ou type de transaction.
• Sur la page Détails du paiement, consultez les informations sur le prestataire correspondant à un paiement donné.
• Sur la page d’analyse des paiements, analysez votre taux global de réussite des paiements pour savoir où les paiements échouent. Filtrez par prestataire pour afficher uniquement les paiements acheminés via un prestataire spécifique.

À l’heure actuelle, le Dashboard n’affiche pas le récapitulatif du solde, les rapports d’activité, l’état des litiges, ou les reçus pour les paiements traités par d’autres prestataires. L’actualisation des données peut prendre jusqu’à 2 jours. Les données Orchestration que nous partageons dans le Dashboard dépendent des données que vous et vos autres prestataires fournissez.