パーソナライズデザインを管理する
パーソナライズデザイン
パーソナライズデザインは、カードをパーソナライズして配送するために必要なすべてのデザイン属性を論理的にまとめたものです。物理バンドルと、カードのパーソナライズを実行するために必要なその他の要素がどちらも含まれています。
- 物理バンドルとは、在庫にある物品のセットであり、カードを発行する際にパーソナライズされて発送されます。詳細については、標準カードまたはカスタムカードをご覧ください。すべての物理バンドルを表示することもできます。
- バンドルによっては、カードのロゴや配送用台紙など、その他のデザイン属性に対応していたり、指定が必要な場合があります。
カードのロゴは、カードの上に印刷される画像で、ファイルをアップロードして Stripe に提出します。Stripe はカードのロゴを一色のみで印刷するため、最高画質で印刷するには、白地に黒のロゴを含む、グレースケールなしの純粋なバイナリのカードロゴ画像にする必要があります。ロゴをアップロードするには、purpose
に issuing_logo
を設定した File API を使用します。
curl https://files.stripe.com/v1/files \ -u
: \ -F "file"="@/path/to/a/file.jpg" \ -F "purpose"="issuing_logo"sk_test_4eC39HqLyjWDarjtT1zdp7dc
配送用台紙に印刷される文字はコンテンツのセットであり、配送用台紙テンプレートに印刷される別個の文字として指定します。パーソナライズデザインの作成時には、使用する物理バンドルと、バンドルで要求される場合はカードのロゴと配送用台紙に印刷される文字の両方を指定する必要があります。
Stripe は、そのデザインで作成されたカードのフルフィルメントを行う前に、デザイン (および基となる物理バンドル) を審査して承認する必要があります。詳細については、パーソナライズデザインの審査をご覧ください。
作成できるパーソナライズデザインの数に制限はありません。これにより、実際のユースケースに最適な物理バンドル、カードのロゴ、配送用台紙に印刷される文字を好きなだけ組み合わせて表現できる柔軟性が生まれます。
パーソナライズデザインのレビュー
パーソナライズデザインにロゴまたは配送用台紙に印刷される文字が含まれる場合、パートナーネットワークによって設定されたガイドラインに準拠していることを確認するために、Stripe はこれを審査する必要があります。デザインの status
フィールドは、審査中、有効、却下済みのいずれであるかを示します。審査中のパーソナライズデザインで作成されたカードは、パーソナライズデザインが審査に合格するまで提供を待機します。物理バンドルがまだ承認されていない場合、パーソナライズデザインは審査中の状態から移行できません。
承認後に、パーソナライズデザインのステータスは active に変わります。active になると、パーソナライズデザインを待機していたカードが提供されます。すでに active のステータスのパーソナライズデザインで作成されたカードは、すぐに提供が行われます。カード保有者ウォッチリストのスクリーニングなど、その他の審査によってもカードがすぐに提供されない場合があることにご注意ください。
初めてパーソナライズデザインを作成するとき、またはパーソナライズデザインが却下された後は、physical_bundle
、card_logo
、carrier_text
の各属性の設定/更新のみが可能です。
デザインの却下に対処する
パーソナライズデザインが却下されると、設定している場合は Webhook で通知されます。パーソナライズデザインオブジェクトが、デザインガイドラインに違反するデザインの部分と、rejection_reasons
属性にある却下の理由を特定します。
却下の理由 | 説明 |
---|---|
non_binary_image | 画像がバイナリではありません。黒と白以外の、グレースケールなどのカラーが含まれています。画像操作ソフトウェアを使用して、画像をバイナリ形式にしきい値設定することができます。 |
network_name | 画像またはテキストで、クレジットカードネットワークの名前が不適切に使用されています。 |
other_entity | 画像またはテキストで、ほかの法人の名称が不適切に使用されています。 |
geographic_location | 画像またはテキストに、地理的な場所の名前が含まれています。 |
non_fiat_currency | 画像またはテキストで、法定通貨以外の通貨に言及しています。 |
promotional_material | 画像またはテキストに、広告、宣材物、キャッチフレーズが含まれています。 |
inappropriate | 画像またはテキストに不適切な内容が含まれています。 |
other | 画像またはテキストに別の何らかの理由でフラグが付けられています。却下への改善策を講じる方法について問い合わせるには、Stripe サポートをご覧ください。 |
関連するデザイン属性を更新して、却下を解消できます。更新が行われるとパーソナライズデザインは審査のステータスに戻り、それらの属性に新たな更新が加えられるのを防ぎます。
ステータスの変更をプログラムによって処理する
Stripe は、パーソナライズデザイン管理をプラットフォームに導入しやすくするために、パーソナライズデザイン更新の Webhook イベントを提供しています。
Webhook イベント | トリガー |
---|---|
issuing_personalization_design.updated | お客様または Stripe がパーソナライズデザインを更新するたびに発生します。 |
issuing_personalization_design.activated | Stripe がパーソナライズデザインのバンドルを有効にし、デザイン審査でデザインが承認されると、その都度発生します。 |
issuing_personalization_design.rejected | パーソナライズデザインが却下されると、その都度発生します。 |
issuing_personalization_design.deactivated | Stripe がパーソナライズデザインのバンドルを無効にすると、その都度発生します。 |
詳細については、Webhook をご覧ください。
ステータスの変更をテストする
Stripe は、パーソナライズデザインのステータスの変更をすべて管理します。ただし、テスト環境のヘルパーをいくつか提供して、お客様がテスト環境でステータスの変更をトリガーして実装をテストできるようにしています。
デフォルトのパーソナライズデザインを設定する
導入を効率化するために、デフォルトのパーソナライズデザインを設定できます。これにより、作成するカードのすべてで、それぞれのパーソナライズデザインを明示的に指定する必要がなくなります。
パーソナライズデザインを作成または更新するときは、is_default
の値を true
に設定します。デフォルトは 1 つしか設定できないので、それまでのデフォルトデザインの is_default
の値は自動的に false
に設定されます。
デフォルトとして設定されたデザインがある場合、パーソナライズデザインを指定せず作成するカードでは自動的にデフォルトが使用されます。デフォルトを設定していないときに、パーソナライズデザインを指定せずカードを作成しようとすると、エラーになります。
カードの作成時に personalization_design
パラメーターを指定することで、デフォルトのパーソナライズデザインを常に上書きできます。
コードをデプロイせずに、検索キーを使用してパーソナライズデザインを変更する
Stripe Issuing を使用する一部のビジネスは、複数のカード商品をカード保有者に提供しています。カード商品のパーソナライズデザインは時間とともに変わることがあります。パーソナライズデザインをハードコード化していて、変更したい場合、多くの場合、そのプロセスでは新しいコードのデプロイが必要になります。検索キーを使用すると、パーソナライズデザインを変更する場合に新しいコードをデプロイする必要がなくなります。
パーソナライズデザインで検索キーを使用するには、パーソナライズデザインの作成時または更新時に lookup_key
パラメーターを渡して一意の検索キーを割り当てます。パーソナライズデザイン ID をハードコード化するのではなく、パーソナライズデザインリストエンドポイントを使用して、一致するパーソナライズデザインの検索キー値とクエリをハードコード化します。
パフォーマンスを向上させるには、キャッシュを行い、必要な場合のみカードデザインの再読み込みを行うことをお勧めします。カード商品のパーソナライズデザインを変更する場合、lookup_key
の既存の値を使用して新しいパーソナライズデザインを作成または更新し、transfer_lookup_key
を true
に設定できます。
Connect を使用してパーソナライズデザインを管理する
Connect を使用する場合は、上記のようにプラットフォームと連結アカウントのどちらのレベルでもパーソナライズデザインを管理できます。ただし、Connect は連結アカウントがプラットフォームレベルのリソースにアクセスできるようにすることで、実装をさらに効率化するいくつかの方法も提供しています。
パーソナライズデザインと物理バンドル
連結アカウントのそれぞれが、プラットフォームレベルで作成されたパーソナライズデザインと物理バンドルにアクセスできます。これにより、以下が可能になります。
- プラットフォームレベルで作成されたパーソナライズデザインで、連結アカウントのカードを発行する。
- プラットフォームのアカウント内で利用できる物理バンドルを使用して、連結アカウントのパーソナライズデザインを作成する。これにより、プラットフォームアカウントでリソースを作成し、すべての連結アカウントで共有できるようになります。明示的に連結アカウントから非表示にする必要があるアイテムや、特定の連結アカウントにのみ使用されるアイテムがない限り、できる限りプラットフォームレベルで管理することをお勧めします。
デフォルトのパーソナライズデザイン
連結アカウントはそれぞれ、自身のデフォルトのパーソナライズデザインを設定できます。さらに、プラットフォームレベルでデフォルトのパーソナライズデザインを設定することもできます。設定すると、デザインを指定せずに連結アカウントのカードを発行し、その連結アカウントにデフォルトがない場合は、プラットフォームのデフォルトが使用されます。
発行済みのカードでプラットフォームのデフォルトを使用する必要がある場合は、連結アカウントのデフォルトのパーソナライズデザインの設定を解除できます。