Zahlungen an mehrere Zahlungsabwickler weiterleitenPrivate Vorschau

Regeln enthalten die Bedingungen und Aktionen für die Weiterleitung von Zahlungen an einen bestimmten Zahlungsabwickler.

1. Erstellen Sie eine Sandbox, wenn Sie noch keine haben. Sie verwenden die Sandbox, um Regeln hinzuzufügen und zu testen, bevor Sie live gehen.
2. Klicken Sie auf der Seite Orchestrierung im Dashboard auf Regeln hinzufügen.
3. Fügen Sie Regeln mit einer Bedingung hinzu, die die Zahlung an einen der verfügbaren Zahlungsabwickler weiterleitet, wenn Card country gleich United Kingdom ist. Fügen Sie eine Aktion hinzu, um die Zahlung an Stripe weiterzuleiten, wenn die Bedingung nicht erfüllt ist.
4. [Optional] Fügen Sie einen Abwickler hinzu, um die Zahlung erneut zu versuchen, falls sie beim Hauptabwickler fehlschlägt.
5. Klicken Sie auf Testregeln aktivieren.

Wenn Sie einen PaymentIntent erstellen, fügen Sie den Parameter payments_orchestration ein, um die Orchestrierung zu aktivieren.

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

Die Orchestrierung unterstützt weder die Setup Intents API noch die Funktionen Flexibles Acquiring bei anderen Zahlungsabwicklern. Bei Transaktionen, die eine 3D Secure-Anfrage beinhalten, sind Sie dafür verantwortlich, Stripe die Acquirer-BIN mitzuteilen, die dem Abwickler entspricht, an den Sie diese Transaktionen weiterleiten. Wenden Sie sich an Ihre/n Stripe-Vertreter/in, wenn Sie sich nicht sicher sind, ob die Orchestrierung die von Ihnen verwendeten Funktionen unterstützt.

Verwenden Sie Testkarten, um sicherzustellen, dass Stripe Zahlungen an die in Ihren Regeln festgelegten Zahlungsabwickler weiterleitet. Um beispielsweise zu testen, ob Zahlungen an den von Ihnen gewählten Zahlungsabwickler weitergeleitet werden, wenn das Land der Karte gleich „Vereinigtes Königreich“ ist, können Sie die Testzahlungsmethode pm_card_gb verwenden:

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

Nachdem Sie eine Testzahlung erstellt haben, können Sie die Detailseite für Ihre Zahlung aufrufen, um festzustellen, an welchen Zahlungsabwickler die Zahlung weitergeleitet wurde. Auf der Seite mit den Zahlungsdetails können Sie den Zahlungsabwickler unter Abwickler sehen. Unter Neueste Aktivität werden auch der Zahlungsabwickler und die Regeln angezeigt, durch die die Zahlung weitergeleitet wurde. Klicken Sie auf den Link, um die Regeln anzuzeigen, durch die diese Zahlung weitergeleitet wurde.

Der Zahlungsdatensatz enthält den Ausführungsverlauf für Zahlungen, bei denen die Orchestrierung aktiviert ist. Rufen Sie den Zahlungsdatensatz mithilfe seiner ID aus dem PaymentIntent ab.

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

Alternativ können Sie die Zahlungsdatensatz-ID im Inspektor in Workbench eingeben.

Überprüfen Sie, an welchen Zahlungsabwickler die Zahlung weitergeleitet wurde, indem Sie den processor_details-Hash anzeigen:

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

Nachdem Sie Ihre Integration getestet haben, verlassen Sie Ihre Sandbox und fügen Sie Regeln für Ihre Live-Integration hinzu. Die Orchestrierung wird aktiviert, sobald Sie Ihre Regeln aktivieren. Erfahren Sie mehr über andere Bedingungen und Aktionen, um Zahlungen weiterzuleiten.

Prozessorleistung überwachen

Nachdem Sie die Orchestrierung für Ihre Live-Zahlungen aktiviert haben, verwenden Sie das Dashboard, um die Leistung für Ihre Abwickler zu überwachen.

• Auf der Seite Orchestrierungsübersicht erhalten Sie Zugriff auf Leistungsanalysen und Zahlungserfolgsquoten bei Ihren Abwicklern. Sie können diese Daten filtern, um die Leistung nach Währung, Kartenmarke, Kartenland, Kartentyp oder Transaktionstyp anzuzeigen.
• Zeigen Sie auf der Seite Zahlungsdetails die Abwicklerinformationen für eine einzelne Zahlung an.
• Analysieren Sie auf der Seite Zahlungsanalysen Ihre Gesamterfolgsquote bei Zahlungen, um herauszufinden, wo Zahlungen fehlschlagen. Verwenden Sie den Abwicklerfilter, um nur die Zahlungen anzuzeigen, die über einen bestimmten Zahlungsabwickler geleitet werden.

Das Dashboard zeigt derzeit keine Saldoübersicht und Aktivitätsberichte, Anfechtungsstatus oder Belege für Zahlungen an, die mit anderen Zahlungsabwicklern abgewickelt wurden. Das Ausfüllen der Daten kann bis zu 2 Tage dauern. Die Orchestrierungsdaten, die wir im Dashboard freigeben, beruhen auf Daten, die von Ihnen und Ihren anderen Abwicklern bereitgestellt werden.