Freigabe von Kundinnen/Kunden und Zahlungsmethoden für mehrere Konten in einer OrganisationÖffentliche Vorschau

Vermeiden Sie die erneute Erfassung von Kunden- und Zahlungsmethodeninformationen von bestehenden Kundinnen/Kunden, die in mehreren Konten angelegt sind.

Viele wachsende Unternehmen erweitern auf mehrere Stripe-Konten, weil Finanzen aus verschiedenen Geschäftsbereichen getrennt bleiben sollen oder weil das Unternehmen in mehreren Regionen mit unterschiedlichen juristischen Personen tätig ist. Als Unternehmen mit mehreren juristischen Personen können Sie Kundinnen/Kunden und Zahlungsmethoden für mehrere Konten in einer Organisation freigeben, um Folgendes zu vermeiden:

Erneute Erfassung von Zahlungsmethoden oder Kontaktinformationen von demselben Kunden/derselben Kundin
Einführung von Inkonsistenzen in den Kontakt- und Zahlungsdaten eines Kunden/einer Kundin zwischen Konten
Doppelte Datensätze verwalten und aktualisieren

Zugriff

Die gemeinsame Nutzung von Kundinnen/Kunden und Zahlungsmethoden befindet sich derzeit in der öffentlichen Vorschau, wobei die folgenden Berechtigungskriterien gelten:

Sie haben weniger als 100 Millionen Kundinnen und Kunden.
Die gemeinsame Nutzung zwischen verbundenen Konten unter einer Plattform ist nicht erforderlich.
Sie verwenden nicht Stripe Apps.

Beschränkungen

Die gemeinsame Nutzung von Kundinnen/Kunden und Zahlungsmethoden befindet sich derzeit in der öffentlichen Vorschau mit den folgenden Einschränkungen:

Sie können ein Konto nicht mehr aus der Freigabe entfernen, nachdem Sie die Funktion aktiviert haben.
Sie können Kundinnen/Kunden und Zahlungsmethoden nur innerhalb einer Organisation teilen, die über mehrere eigenständige Konten oder Plattformkonten verfügt. Sie können Kundinnen/Kunden oder Zahlungsmethoden nicht für alle verbundene Konten freigeben.
Sie können Zahlungsmethoden nur dann für mehrere Konten freigeben, wenn der Typ card ist. Sie können andere wiederverwendbare Zahlungsmethoden in einem Konto speichern, aber nicht mit anderen Konten teilen.
Sie können nur Kartenzahlungsmethoden teilen, die von einer Wallet mit Apple Pay und Link stammen.
Sie können nicht selektiv einzelne Kundinnen/Kunden oder Zahlungsmethoden teilen. Wenn Sie Konten aktivieren, werden alle Kundinnen/Kunden und Zahlungsmethoden gemeinsam genutzt.

Bevor Sie loslegen

Erstellen Sie eine Organisation für Ihre mehreren eigenständigen Konten.
Erstellen Sie eine Sandbox-Umgebung für Ihre Organisation und deren Konten, damit Sie Ihre Integration testen können, bevor Sie sie in den Produktionsbetrieb überführen.

Sie können die Freigabe für eine bestimmte Gruppe von Konten in Ihrer Organisation oder für alle Konten aktivieren.

Klicken Sie in Ihren Organisationseinstellungen im Dashboard auf Gemeinsame Nutzung von Kundinnen/Kunden und Zahlungsmethoden, um loszulegen.
Wählen Sie die Konten aus, für die Sie die Freigabe aktivieren möchten, und klicken Sie auf Teilen. Sie müssen mindestens zwei Konten auswählen.
Legen Sie einen Namen für Ihre Freigabegruppe fest. Konten können nur zu einer Gruppe gehören.
Aktivieren Sie das Kontrollkästchen, um zu bestätigen, dass Sie von Ihren Kundinnen/Kunden die Zustimmung zum Teilen von Kontakt- und Zahlungsmethodeninformationen für alle Konten in Ihrem Unternehmen erhalten haben.
Klicken Sie auf Aktivieren.

Sie können die Freigabe für nicht freigegebene Konten jederzeit aktivieren, aber Sie können die Freigabe für aktivierte Konten nicht rückgängig machen. Sie müssen Stripe kontaktieren, wenn Sie die Freigabe deaktivieren möchten.

Nachdem ein Konto in der Freigabegruppe einen Kunden/eine Kundin erstellt hat, erstellt Stripe diesen Kunden/diese Kundin automatisch in allen anderen Konten in der Gruppe. Jedes Konto in der Freigabegruppe verwaltet seine eigene Instanz des gemeinsam genutzten Kunden/der gemeinsamen Kundin, aber alle Instanzen haben dieselbe Kunden-ID.

Jedes Konto in der Freigabegruppe kann den Kunden/die Kundin über das Dashboard oder die API aktualisieren. Aktualisierungen an den folgenden Feldern des Customer-Objekts werden für alle Kontoinstanzen in der Freigabegruppe synchronisiert:

Aktualisierungen an anderen Feldern innerhalb eines Kontos werden in der Customer-Instanz des Kontos gespeichert, das die Aktualisierung vornimmt, aber nicht mit anderen Konten in der Freigabegruppe synchronisiert. Es ist möglich, dass derselbe Kunde/dieselbe Kundin in verschiedenen Kontoinstanzen unterschiedliche Werte für dasselbe nicht gemeinsam genutzte Feld verwendet. Dadurch wird die Integrität von Kundendaten geschützt, die möglicherweise proprietär, sensibel oder nur für ein Konto relevant sind.

Zahlungsmethoden

Im Gegensatz zu Kundeninstanzen erstellt Stripe die Zahlungsmethode nur im Ursprungskonto. Allerdings kann jedes Konto in der Freigabegruppe diese einzelne Zahlungsmethodeninstanz belasten, aktualisieren und sogar löschen. Aktualisierungen einer gemeinsam genutzten Zahlungsmethode (einschließlich Entfernen) werden mit allen Konten in der Freigabegruppe synchronisiert. Die folgende Aktivität gilt jedoch nur für das Ursprungskonto:

Stripe generiert payment_method.<action>-Ereignisse nur für das ursprüngliche Konto.
Stripe berechnet die Gebühren für Kartenaktualisierer (Card Account Updater,CAU) nur dem Ursprungskonto.

Ereignisverhalten

Wenn ein Konto eines der freigegebenen Felder für einen Kunden/eine Kundin aktualisiert, generiert Stripe separate customer.updated-Ereignisse für jedes Konto in der Freigabegruppe. Wenn ein Konto ein nicht freigegebenes Feld für den Kunden/die Kundin aktualisiert, sendet Stripe das Ereignis customer.updated nur an dieses Konto.

Wenn ein Konto einem/einer Kund/in eine Zahlungsmethode hinzufügt, generiert Stripe ein einzelnes payment_method.attached-Ereignis nur für das Ursprungskonto.

Wir empfehlen, dass alle Konten in einer Freigabegruppe Ereignisse mit einem Webhook auf Organisationsebene überwachen, damit Sie über die Aktivität der freigegebenen Zahlungsmethode informiert sind.

Use cases für die Beispielintegration Server-side

Die folgenden Abschnitte enthalten Codebeispiele, die veranschaulichen, wie Konten in einer Organisationsfreigabegruppe freigegebene Daten abrufen und verwenden können. Diese Beispiele spiegeln eine Organisation mit folgendem Setup wider:

Kunde/Kundin beim Bezahlvorgangs erstellen

Ein Kunde/eine Kundin tätigt eine Zahlung auf eines der Konten in einer Freigabegruppe (Rocket Rides). Die CheckoutSession ermöglicht customer_creation und payment_method_save.

server.js
const stripe = require('stripe')('{{SECRET_KEY_ROCKET_RIDES}}');

const session = await stripe.checkout.sessions.create({
  customer_creation: 'always',
  line_items: [
    {
      price_data: {
        currency: 'usd',
        product_data: {
          name: 'ride_service',
        },
        unit_amount: 2000,
      },
      quantity: 1,
    },
  ],
  mode: 'payment',
  ui_mode: 'embedded',
  return_url: 'https://checkout.rocket-rides.com/checkout/return?session_id={CHECKOUT_SESSION_ID}',
  saved_payment_method_options: {
    payment_method_save: 'enabled',
  },
});

Nach Durchführung der Zahlung teilt Stripe das neue Kundenkonto und die Zahlungsmethode mit den anderen Konten in der Freigabgruppe. Stripe löst die folgenden Ereignisse aus:

customer.created für jede Kontoinstanz des Kunden/der Kundin
Ereignis payment_method.attached nur für das ursprüngliche Konto

Weitergegebene Kundendaten von einem anderen Konto aktualisieren

Rocket Deliveries aktualisiert das ursprünglich von Rocket Rides gespeicherte gemeinsam genutzte Kundenkonto.

server.js
const stripe = require('stripe')('{{SECRET_KEY_ROCKET_DELIVERIES}}');

const customer = await stripe.customers.update('{{CUSTOMER_ID}}'
,
  {
    email: 'jenny@example.com',
    metadata: {
      door: "front"
    },
  }
);

Stripe löst das Ereignis customer.updated für jedes Konto in der Freigabegruppe aus:

Die Instanz jedes Kontos des Kunden/der Kundin erhält die email-Aktualisierung.
Nur das Konto von Rocket Delivery erhält die Aktualisierung metadata_door, da es sich nicht um ein gemeinsam genutztes Feld handelt.

Freigegebene Zahlungsmethoden eines Kunden/einer Kundin abrufen

Alle Konten in einer Freigabegruppe können die gespeicherten kartenbasierten Zahlungsmethoden eines Kunden/einer Kundin auflisten und diese verwenden oder aktualisieren.

Wenn ein Kunde/eine Kundin mehrere Zahlungsmethoden für mehrere Konten in einer Freigabegruppe gespeichert hat, begrenzt Stripe die abgerufenen Konten, um die Leistung zu priorisieren. Wir rufen Zahlungsmethoden nur von dem Konto ab, das die Anfrage stellt, und von den vier Konten mit den zuletzt angehängten Zahlungsmethoden.

server.js
const stripe = require('stripe')('{{SECRET_KEY_ROCKET_REPAIRS}}');

const paymentMethods = await stripe.customers.listPaymentMethods('{{CUSTOMER_ID}}'
);

Gemeinsame Zahlungsmethoden von Kundinnen/Kunden aktualisieren

Aktualisierungen einer gemeinsam genutzten Zahlungsmethode (einschließlich Entfernen) werden mit allen Konten in der Freigabegruppe synchronisiert und lösen das Ereignis payment_method.updated oder payment_method.detachedaus.

server.js
const stripe = require('stripe')('{{SECRET_KEY_ROCKET_REPAIRS}}');

const paymentMethod = await stripe.paymentMethods.update('{{PAYMENT_METHOD_ID}}'
,
  {
    "billing_details": {
      "address": {
        "city": "South San Francisco",
        "country": "us",
        "line1": "354 Oyster Point Boulevard",
        "line2": null,
        "postal_code": "94080",
        "state": "CA"
      },
    },
  }
);

Wiederkehrende Zahlungen in Betracht ziehen

Änderungen an Zahlungsmethoden können sich auf laufende Abonnements mit dieser Zahlungsmethode auswirken. Gehen Sie daher sorgfältig vor.

Zahlung über eine gemeinsam genutzte Zahlungsmethode annehmen Server-side

Sie können eine in einem Konto gespeicherte Zahlungsmethode (z. B. Rocket Rides) für eine Zahlung belasten, die von einem anderen Konto in der Freigabegruppe erstellt wurde (z. B. Rocket Repairs).

server.js
const stripe = require('stripe')('{{SECRET_KEY_ROCKET_REPAIRS}}');

const session = await stripe.checkout.sessions.create({
  customer:'{{CUSTOMER_ID}}'
,
  line_items: [
    {
      price_data: {
        currency: 'usd',
        product_data: {
          name: 'tow_service',
        },
        unit_amount: 5000,
      },
      quantity: 1,
    },
  ],
  mode: 'payment',
  ui_mode: 'embedded',
  return_url: 'https://checkout.rocket-repairs.com/checkout/return?session_id={CHECKOUT_SESSION_ID}',
  saved_payment_method_options: {
    payment_method_save: 'enabled',
  },
});

Zahlungen werden auf der Seite Transaktionen für das entsprechende Konto und die Organisation angezeigt. Konten können die Zahlungen der anderen nicht sehen, auch wenn sie Teil der Freigabegruppe sind.

Erstellen Sie ein Abonnement mit einer gemeinsam genutzten Zahlungsmethode Server-side

Sie können auch ein Abonnement für einen Kunden/eine Kundin erstellen, der/die ursprünglich von einem anderen Konto in der Freigabegruppe gespeichert wurde.

server.js
const stripe = require('stripe')('{{SECRET_KEY_ROCKET_REPAIRS}}');

const session = await stripe.checkout.sessions.create({
  customer:'{{CUSTOMER_ID}}'
,
  line_items: [
    {
      price_data: {
        currency: 'usd',
        product_data: {
          name: 'basic-roadside-service',
        },
        unit_amount: 2500,
      },
      quantity: 1,
    },
  ],
  mode: 'subscription',
  ui_mode: 'embedded',
  return_url: 'https://checkout.rocket-repairs.com/checkout/return?session_id={CHECKOUT_SESSION_ID}',
  saved_payment_method_options: {
    payment_method_save: 'enabled',
  },
});