確認ページとメールでのスマートタグの使用

スマートタグとは？

スマートタグは、支払い確認ページ、領収書、メールで、顧客と支払いに関する関連情報に動的に置き換わるプレースホルダーテキストの一種です。

スマートタグは波括弧を使用し、次のような形式になります。

{smart-tag}

スマートタグの使用方法

スマートタグは、支払い確認ページおよびWP Simple Payのメールで使用できます。これらのユースケースの例については、リンクをクリックしてください。

支払い確認ページ例

以下は、定期払い確認ページのデフォルトテキストです。いくつかのスマートタグが既に使用されています。このドキュメントのさらに下にあるスマートタグ参照リストから、追加のスマートタグを追加できます。

メール例

以下は、請求書支払い確認メールのデフォルトテキストです。いくつかのスマートタグが既に使用されていることに注意してください。このドキュメントのさらに下にあるスマートタグ参照リストから、追加のスマートタグを追加できます。

利用可能なスマートタグ

支払い確認ページとメールをカスタマイズするために、WP Simple Payに組み込まれているスマートタグは次のとおりです。

受領タグ

フォーム関連スマートタグ

顧客関連スマートタグ

支払い関連スマートタグ（一括払いおよびサブスクリプション支払い）

サブスクリプション固有のスマートタグ

高度でカスタムなスマートタグの作成

高度なスマートタグ

支払いまたはサブスクリプションに関連する追加情報を出力するには、{payment:key}および{customer:key}スマートタグを使用してStripeオブジェクトデータにアクセスします。

あなたは、顧客、支払い、サブスクリプション、または請求書のレコードのプロパティにアクセスするために、独自のスマートタグを生成できます。例：

例：

• {payment:currency}
• {subscription:currency}
• {subscription:latest_invoice:number}
• {customer:address:line1}
• {customer:address:line2}
• {customer:address:city}
• {customer:address:state}
• {customer:address:postal_code}
• {customer:phone}
• {customer:shipping:address:line1}
• {customer:shipping:address:line2}
• {customer:shipping:address:city}
• {customer:shipping:address:state}
• {customer:shipping:address:postal_code}

すべてのネストされたオブジェクトが展開または利用可能であるわけではありません。

これらのカスタムスマートタグを使用すると、よりパーソナルで柔軟な支払い確認ページやメールを作成できます。

カスタムスマートタグ

ユーザーデータを収集するためにカスタムフォームフィールドを使用する場合、そのデータを他の目的で使用したい場合があります。以下に、カスタムフォームフィールドデータを収集し、支払い確認ページやさまざまなメールで使用し、Stripeダッシュボードに記録する方法を示します。

カスタムフィールドを追加する際には、Stripeダッシュボードに表示したいラベルを**Stripeメタデータラベル**エリアに入力します。

適切なスマートタグが自動的に表示されます。

コピーしたら、そのスマートタグを支払い確認ページ、WP Simple Payのメールなどに貼り付けることができます。

すべてのカスタムフォームフィールドラベルと送信されたデータは、Stripe支払いオブジェクトの**メタデータ**セクションにも自動的に送信されます。

オプションフィールドのフォールバック値

名前フィールドやフォームの説明などのオプションフォームフィールドのスマートタグを追加する際に、通知メールや確認ページにフォールバック値を提供できます。