Personalisierungsdesigns verwalten
Personalisierungsdesigns
Ein Personalisierungsdesign ist eine logische Gruppierung aller Design-Attribute, die zum Personalisieren und Versenden einer Karte erforderlich sind. Sie enthält sowohl ein physisches Paket als auch alle anderen Elemente, die für die Personalisierung einer Karte erforderlich sind:
- Ein physisches Paket ist ein Satz physischer Waren im Bestand, die personalisiert und versendet werden, wenn Sie eine Karte ausstellen. Weitere Informationen finden Sie unter Standardkarten oder Nutzerspezifische Karten. Sie können auch alle Ihre physischen Pakete anzeigen.
- Einige Pakete unterstützen oder erfordern andere Design-Attribute, wie Kartenlogos und Text des Anbieters.
Ein Kartenlogo ist ein auf die Karte gedrucktes Bild, das Sie Stripe als Datei-Upload zur Verfügung stellen. Stripe druckt Kartenlogos nur einfarbig. Für einen qualitativ hochwertigen Druck setzen wir also voraus, dass die Kartenlogos rein binär sind und ein schwarzes Logo auf weißem Hintergrund ohne Graustufen enthalten. Um ein Logo hochzuladen, verwenden Sie die Datei-API mit dem purpose
auf issuing_logo
.
curl https://files.stripe.com/v1/files \ -u
: \ -F "file"="@/path/to/a/file.jpg" \ -F "purpose"="issuing_logo"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Beim Zustellertext handelt es sich um eine Reihe von Inhalten, die Sie als separate Texte bereitstellen, die auf eine Vorlage für ein Zustellungsschreiben gedruckt sind. Wenn Sie ein Personalisierungsdesign erstellen, müssen Sie sowohl das physische Paket als auch ein Kartenlogo und den Zustellertext angeben, wenn das Paket dies erfordert.
Stripe muss Ihr Design (und das zugrunde liegende physische Paket) überprüfen und genehmigen, bevor Karten mit diesem Design erstellt werden. Weitere Informationen finden Sie unter Überprüfen des Personalisierungsdesigns.
Es gibt keine Begrenzung für die Anzahl der Personalisierungsdesigns, die Sie erstellen können. Auf diese Weise können Sie beliebig viele Kombinationen aus physischen Paketen, Kartenlogos und Zustellertexten angeben, die für Ihr Anwendungsszenario am besten geeignet sind.
Überprüfung des Personalisierungsdesigns
Wenn Ihr Personalisierungsdesign ein Logo oder einen Zustellertext enthält, muss Stripe diese überprüfen, um sicherzustellen, dass sie den Richtlinien unserer Partnernetzwerke entsprechen. Das Feld status
eines Designs gibt an, ob es geprüft wird, aktiv ist oder abgelehnt wird. Karten, die derzeit geprüft werden, warten auf die Ausführung, bis die Prüfung für das Personalisierungsdesign abgeschlossen wurde. Ein Personalisierungsdesign kann den Überprüfungsstatus nicht verlassen, wenn sein physisches Paket noch nicht genehmigt wurde.
Nach der Genehmigung wechselt der Status des Personalisierungsdesigns zu aktiv. Nachdem sie aktiv geworden sind, können alle ausgeführten Karten, die auf das Personalisierungsdesign warten, ausgeführt werden. Alle Karten, die mit einem bereits aktiven Personalisierungsdesign erstellt wurden, können sofort zugestellt werden. Beachten Sie, dass andere Überprüfungen, wie z. B. die Überprüfung von Karteninhaber/innen, verhindern, dass eine Karte sofort ausgeführt wird.
Sie können die Attribute physical_bundle
, card_logo
und carrier_text
nur festlegen/aktualisieren, wenn Sie das Personalisierungsdesign zum ersten Mal erstellen oder nachdem das Personalisierungsdesign abgelehnt wurde.
Umgang mit Ablehnungen von Designs
Wenn ein Personalisierungsdesign abgelehnt wird, werden Sie, sofern konfiguriert, per Webhook benachrichtigt. Das Personalisierungsdesign-Objekt gibt im Attribut rejection_reasons
an, welcher Teil des Designs gegen die Design-Richtlinien verstößt, sowie den Grund für die Ablehnung.
Ablehnungsgrund | Erklärung |
---|---|
non_binary_image | Das Bild ist nicht binär – es enthält andere Farben als Schwarz und Weiß, einschließlich Graustufen. Sie können Bildbearbeitungssoftware verwenden, um das Bild in binäre Form zu übertragen. |
network_name | Das Bild oder der Text verwendet fälschlicherweise den Namen eines Kreditkartennetzwerks. |
other_entity | Das Bild oder der Text verwendet fälschlicherweise den Namen einer anderen Einheit. |
geographic_location | Das Bild oder der Text enthält den Namen eines geografischen Standorts. |
non_fiat_currency | Das Bild oder der Text enthält einen Verweis auf eine andere Währung. |
promotional_material | Das Bild oder der Text enthält Werbung, Verkaufsförderungsmaterial oder einen Slogan. |
unangemessen | Das Bild oder der Text enthält unangemessene Inhalte. |
Sonstiges | Das Bild oder der Text wurde aus einem anderen Grund markiert. Wenden Sie sich an den Stripe-Support, um zu erfahren, wie die Ablehnung behoben werden kann. |
Sie können die relevanten Design-Attribute aktualisieren, um die Ablehnung zu beheben. Bei allen Aktualisierungen wird der Überprüfungsstatus des Personalisierungsdesigns zurückgesetzt. Dadurch werden weitere Aktualisierungen dieser Attribute verhindert.
Statusänderungen programmgesteuert verarbeiten
Stripe stellt Webhook-Ereignisse für Aktualisierungen des Personalisierungsdesigns bereit, damit Sie die Verwaltung des Personalisierungsdesigns in Ihre eigene Plattform integrieren können.
Webhook Ereignis | Auslöser |
---|---|
issuing_personalization_design.updated | Tritt auf, wenn Sie oder Stripe ein Personalisierungsdesign aktualisieren. |
issuing_personalization_design.activated | Tritt auf, wenn Stripe das Paket für ein Personalisierungsdesign aktiviert und das Design in der Design-Prüfung genehmigt wird. |
issuing_personalization_design.rejected | Tritt auf, wenn ein Personalisierungsdesign ein Personalisierungsdesign ablehnt. |
issuing_personalization_design.deactivated | Tritt auf, wenn Stripe das Paket für ein Personalisierungsdesign deaktiviert. |
Weitere Informationen finden Sie unter Webhooks.
Änderungen des Teststatus
Stripe steuert alle Statusänderungen an einem Personalisierungsdesign. Wir stellen jedoch mehrere Testmodus-Hilfsprogramme bereit, mit denen Sie Ihre Integration testen können, indem Sie selbst Statusänderungen im Testmodus auslösen:
Ein Standard-Personalisierungsdesign festlegen
Um Ihre Integration zu optimieren, können Sie ein Standard-Personalisierungsdesign festlegen, sodass Sie nicht für jede erstellte Karte ein Personalisierungsdesign angeben müssen.
Legen Sie beim Erstellen oder Aktualisieren eines Personalisierungsdesigns die Einstellung is_default
auf true
fest. Die Einstellung is_default
für das vorherige Standarddesign wird automatisch auf false
festgelegt, da es nur eine Standardeinstellung geben kann.
Nachdem Sie einen Standard festgelegt haben, wird für alle Karten, die Sie ohne Angabe eines Personalisierungsdesigns erstellen, automatisch der Standard verwendet. Der Versuch, eine Karte zu erstellen, ohne ein Personalisierungsdesign anzugeben, obwohl keine Standardeinstellungen festgelegt sind, führt zu einem Fehler.
Sie können das standardmäßige Personalisierungsdesign beim Erstellen einer Karte jederzeit überschreiben, indem Sie den Parameter personalization_design
angeben.
Personalisierungsdesigns ändern, ohne Code mithilfe von Suchschlüsseln bereitzustellen
Einige auf Stripe Issuing aufgebaute Unternehmen bieten ihren Karteninhabern und -inhaberinnen mehrere Kartenprodukte an. Das Personalisierungsdesign des Kartenprodukts kann sich im Laufe der Zeit ändern. Wenn Sie Ihre Personalisierungsdesigns hartkodiert haben und diese ändern möchten, müssen Sie häufig neuen Code bereitstellen. Sie können das Attribut Suchschlüssel verwenden, um beim Ändern von Personalisierungsdesigns keinen neuen Code bereitstellen zu müssen.
Um Suchschlüssel mit Personalisierungsdesigns zu verwenden, können Sie einen eindeutigen Suchschlüssel zuweisen, indem Sie beim Erstellen oder Aktualisieren eines Personalisierungsdesigns den Parameter lookup_key
übergeben. Anstatt eine Kartendesign-ID fest zu codieren, codieren Sie den Suchschlüsselwert fest und fragen das übereinstimmende Personalisierungsdesigns mithilfe des Personalisierungsdesigns-Listen-Endpoints ab.
Um die Leistung zu verbessern, möchten Sie möglicherweise das Personalisierungsdesign zwischenspeichern und/oder nur gelegentlich neu laden. Wenn das Personalisierungsdesign für ein Kartenprodukt geändert werden soll, erstellen oder aktualisieren Sie ein neues Personalisierungsdesign unter Verwendung des vorhandenen Werts für lookup_key
und legen gleichzeitig transfer_lookup_key
auf true
fest.
Personalisierungsdesigns mit Connect verwalten
Bei Verwendung von Connect können Personalisierungsdesigns wie oben beschrieben sowohl auf Ebene der Plattform als auch der verbundenen Konten verwaltet werden. Connect bietet Ihnen jedoch auch einige Möglichkeiten, Ihre Integration noch weiter zu optimieren, indem verbundene Konten Zugriff auf Ressourcen auf Plattformebene gewähren.
Personalisierungsdesigns und physische Pakete
Jedes Ihrer verbundenen Konten kann auf Personalisierungsdesigns und physische Pakete zugreifen, die auf Plattformebene erstellt wurden. Dies bedeutet, dass Sie:
- Karten von einem verbundenen Konto mit einem auf der Plattform erstellten Personalisierungsdesign ausstellen können.
- Erstellen Sie ein Personalisierungsdesign für ein verbundenes Konto mit einem physischen Paket, das im Konto der Plattform verfügbar ist. Auf diese Weise können Sie diese Ressourcen in Ihrem Plattformkonto erstellen und für alle Ihre verbundenen Konten freigeben. Wir empfehlen, so viel wie möglich auf Plattformebene zu verwalten, es sei denn, es gibt Elemente, die explizit für ein verbundenes Konto ausgeblendet werden sollten oder immer nur für bestimmte verbundene Konten verwendet werden.
Standard-Personalisierungsdesigns
Für jedes Ihrer verbundenen Konten kann ein eigenes Standard-Personalisierungsdesign festgelegt werden. Darüber hinaus können Sie auf Plattformebene ein Standard-Personalisierungsdesign festlegen. Ist dies geschehen, wird der Plattformstandard verwendet, wenn Sie eine Karte für ein verbundenes Konto ausstellen, ohne ein Design anzugeben, und für dieses verbundene Konto sind keine eigenen Standardeinstellungen vorhanden.
Wenn Sie möchten, dass für die ausgestellten Karten die Standardeinstellungen der Plattform verwendet werden, können Sie das Standard-Personalisierungsdesign für das verbundene Konto deaktivieren.