Gérer les designs personnalisés
Designs personnalisés
Un design personnalisé est un regroupement logique de tous les attributs de design requis pour personnaliser et envoyer une carte. Il comprend à la fois un forfait physique et tout autre élément nécessaire à la personnalisation d’une carte :
- Un forfait physique est un ensemble de marchandises en stock qui sont personnalisées et expédiées lorsque vous émettez une carte. Consultez les pages consacrées aux cartes standard ou aux cartes personnalisées pour en savoir plus. Vous pouvez également afficher tous vos forfaits physiques.
- Certains forfaits prennent en charge ou exigent d’autres attributs de conception, tels que les logos de carte et le courrier d’accompagnement.
Un logo de carte est une image imprimée sur la carte, que vous fournissez à Stripe en chargeant votre fichier. Stripe n’imprimant les logos de carte que dans une seule couleur, les images du logo de carte doivent être binaires et contenir un logo noir sur fond blanc sans niveaux de gris. Pour charger un logo, utilisez l’API File en définissant purpose
sur issuing_logo
.
curl https://files.stripe.com/v1/files \ -u
: \ -F "file"="@/path/to/a/file.jpg" \ -F "purpose"="issuing_logo"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Le courrier d’accompagnement est un ensemble de contenus que vous fournissez sous forme de textes distincts, imprimés sur un modèle de courrier d’accompagnement. Lorsque vous créez un design personnalisé, vous devez spécifier à la fois le forfait physique à utiliser, le logo de la carte et le courrier d’accompagnement, le cas échéant.
Stripe doit examiner et approuver votre design (et le forfait physique sous-jacent) avant de traiter les cartes créées avec ce design. Pour en savoir plus, consultez la section Vérification du design personnalisé.
Vous pouvez créer autant de designs personnalisés que vous le souhaitez. Cela vous donne la possibilité de créer autant de combinaisons que vous le souhaitez (forfait physique, logo de la carte et courrier d’accompagnement) en fonction de votre cas d’usage.
Vérification du design personnalisé
Si votre design personnalisé comprend un logo ou un courrier d’accompagnement, Stripe doit le vérifier pour s’assurer qu’il est conforme aux directives définies par ses réseaux partenaires. Le champ status
d’un design indique s’il est en cours de vérification, actif ou rejeté. Les cartes dont le design personnalisé est en cours de vérification sont en attente de traitement jusqu’à ce que le design personnalisé soit validé. Les designs personnalisés restent à l’état de vérification tant que le forfait physique des cartes concernées n’a pas été approuvé.
Une fois le design personnalisé approuvé, il passe à l’état actif. Toutes les cartes en attente de traitement peuvent dès lors être traitées. Si le design personnalisé est déjà actif, les cartes utilisant ce design peuvent être traitées immédiatement. D’autres vérifications, telles que la vérification de la liste de surveillance des titulaires de carte, peuvent également empêcher le traitement immédiat d’une carte.
Vous pouvez uniquement définir/mettre à jour les attributs physical_bundle
, card_logo
et carrier_text
lorsque vous créez un design personnalisé pour la première fois, ou s’il a déjà été rejeté.
Gérer les designs rejetés
Lorsqu’un design personnalisé est rejeté, vous recevez un webhook, si vous avez configuré l’envoi de webhooks. L’objet de design personnalisé identifie la partie du design qui enfreint les directives de conception et le ou les motifs du rejet dans l’attribut rejection_reasons
.
Motif du rejet | Explication |
---|---|
non_binary_image | L’image n’est pas binaire : elle contient des couleurs, dont des niveaux de gris autres que le noir et le blanc. Vous pouvez utiliser un logiciel de traitement d’images pour traiter l’image de façon à ce qu’elle soit binaire. |
network_name | L’image ou le texte utilise indûment le nom d’un réseau de cartes bancaires. |
other_entity | L’image ou le texte utilise indûment le nom d’une autre entité. |
geographic_location | L’image ou le texte comporte le nom d’un lieu géographique. |
non_fiat_currency | L’image ou le texte fait référence à une monnaie non fiduciaire. |
promotional_material | L’image ou le texte comporte de la publicité, des éléments promotionnels ou un slogan. |
inapproprié | L’image ou le texte comporte du contenu inapproprié. |
autre | L’image ou le texte a été signalé pour une autre raison. Contactez le service d’assistance Stripe pour régler ce problème de rejet du design. |
Vous pouvez modifier les attributs de conception pertinents pour traiter le rejet. En cas de modification, le design personnalisé passe à nouveau à l’état de vérification, ce qui empêche toute nouvelle modification de ces attributs.
Gérer les changements d’état de manière programmatique
Stripe envoie des événements de webhook lors des mises à jour des designs personnalisés afin de vous aider à intégrer la gestion de ce design à votre propre plateforme.
Événement webhook | Déclencheur |
---|---|
issuing_personalization_design.updated | Se produit chaque fois que Stripe ou vous-même mettez à jour un design personnalisé. |
issuing_personalization_design.activated | Se produit lorsque Stripe active le forfait groupé pour personnaliser un design et que le design est approuvé suite à la phase de validation. |
issuing_personalization_design.rejected | Se produit chaque fois qu’un design personnalisé est rejeté. |
issuing_personalization_design.deactivated | Se produit lorsque Stripe désactive le forfait associé à un design personnalisé. |
Consultez la page webhooks pour en savoir plus.
Changements d’état en mode test
Stripe gère tous les changements d’état des designs personnalisés. Cependant, nous proposons plusieurs assistants en mode test pour que vous puissiez tester votre intégration en déclenchant vous-même les changements d’état :
Définir un design personnalisé par défaut
Pour simplifier votre intégration, vous pouvez définir un design personnalisé par défaut afin de ne pas avoir à préciser le design personnalisé de toutes les cartes que vous créez.
Lors de la création ou de la mise à jour d’un design personnalisé, attribuez la valeur true
à la préférence is_default
. La préférence is_default
du design par défaut précédent reçoit alors automatiquement la valeur false
, car il ne peut y avoir qu’un seul design par défaut.
Si vous avez défini un design par défaut, il sera utilisé pour toutes les cartes créées sans aucun design spécifié. Si vous tentez de créer une carte sans spécifier de design personnalisé alors que vous n’avez pas défini de design par défaut, vous recevrez une erreur.
Vous pouvez toujours remplacer le design personnalisé par défaut lorsque vous créez une carte en spécifiant le paramètre personalization_design
.
Modifier les designs personnalisés sans déployer de code à l’aide de clés de recherche
Certaines entreprises utilisant Stripe Issuing proposent plusieurs produits de carte à leurs titulaires de carte. Le design personnalisé propre à chaque produit peut évoluer. Si vous codez en dur vos designs personnalisés et que vous souhaitez les modifier, vous devrez souvent déployer un nouveau code. Vous pouvez utiliser des clés de recherche pour ne plus avoir à déployer de nouveau code lorsque vous souhaitez modifier les design personnalisés.
Pour utiliser des clés de recherche avec des designs personnalisés, vous pouvez affecter une clé de recherche unique en transmettant le paramètre lookup_key
lors de la création ou la mise à jour d’un design personnalisé. Codez en dur la valeur de la clé de recherche (plutôt que l’ID de design personnalisé) et recherchez le design personnalisé correspondant à l’aide de l’endpoint Personalization Design List.
Pour gagner en performance, vous pouvez mettre en cache et/ou recharger le design personnalisé de façon occasionnelle. Lorsque vous souhaitez créer un nouveau design ou modifier le design personnalisé d’un produit de carte, il vous suffit de mettre à jour le design en utilisant la valeur existante pour lookup_key
et en définissant transfer_lookup_key
sur true
.
Gérer les designs personnalisés à l’aide de Connect
Lorsque vous utilisez Connect, les designs personnalisés peuvent être gérés à la fois au niveau de la plateforme et du compte connecté, comme décrit ci-dessus. Cependant, Connect vous permet de simplifier encore davantage votre intégration en permettant aux comptes connectés d’accéder aux ressources au niveau de la plateforme.
Designs personnalisés et forfaits physiques
Tous vos comptes connectés peuvent accéder aux designs personnalisés et aux forfaits physiques créés au niveau de la plateforme. Cela signifie que vous pouvez :
- Émettez des cartes à partir d’un compte connecté avec un design personnalisé créé sur la plateforme.
- Créer un design personnalisé sur un compte connecté à l’aide d’un forfait physique disponible dans le compte de la plateforme. Cela vous permet de créer ces ressources sur le compte de votre plateforme et de les partager sur tous vos comptes connectés. Nous vous recommandons de gérer vos designs au niveau de la plateforme, sauf si certains éléments doivent être explicitement masqués pour un compte connecté, ou seront uniquement utilisés pour des comptes connectés spécifiques.
Designs personnalisés par défaut
Tous vos comptes connectés peuvent configurer leur propre design personnalisé par défaut. Vous pouvez également définir un design personnalisé par défaut au niveau de la plateforme. Dans ce cas, le design personnalisé par défaut de la plateforme sera utilisé chaque fois que vous émettrez une carte sans spécifier de design, pour un compte connecté qui n’aura pas configuré de design par défaut.
Si vous souhaitez que les cartes émises utilisent la configuration par défaut de la plateforme, vous pouvez désactiver la personnalisation par défaut du compte connecté.