Custom Field Types Reference

読むのにかかる時間: 10分 | 難易度: 初級

概要

フォームビルダーの フォームフィールド タブは、顧客が支払いフォームで表示および入力する内容を作成する場所です。 フィールドを選択… をクリックすると、顧客情報、表示要素、支払い選択、および送信ボタン自体をカバーする19種類のフィールドタイプが表示されます。

この記事は、すべてのフィールドタイプの完全なリファレンスです。カスタムフィールドの一般的な設定方法（追加、並べ替え、削除、必須マーク付け）については、まず 支払いフォームのフィールドの設定とカスタムデータの収集方法 を参照してください。

前提条件

• WP Simple Pay Pro（基本的なカスタムフィールドを超えるにはProが必要です）
• フォームエディタで開かれた支払いフォーム

フィールドカテゴリ

19種類のフィールドは、4つの機能グループに分類されます。

グループ	フィールド
顧客情報	氏名、メールアドレス、電話番号、住所、納税者番号、日付
支払い選択	価格選択、カスタム金額入力、クーポン、定期支払い切り替え、手数料回復切り替え、金額の内訳、支払い方法
フォーム構造/表示	見出し、テキスト、ドロップダウン、ラジオ選択
送信トリガー	チェックアウトボタン、支払いボタン

---

顧客情報フィールド

名前

顧客のフルネームを収集し、Stripeの顧客レコードに保存します。Stripeとの互換性のために、内部的には姓/名に分割されます。

• 必須: カード支払い、ほとんどの規制遵守、およびメール内の{customer-name}のような便利なスマートタグ置換。
• オプション: ラベル、プレースホルダー、必須切り替え。

メールアドレス

顧客の連絡先アドレスおよびStripeの顧客メールとして使用されるメールアドレスを収集します。フォームが支払い領収書を送信する場合、常に必須です。

• 必須: 領収書、サブスクリプション管理リンク、カート放棄リカバリ、ACH/SEPA/Bacs（これらの方法ではStripeはメールを必要とします）。
• オプション: ラベル、プレースホルダー、必須切り替え。

電話番号

国際フォーマットをサポートする顧客の電話番号を収集します。

• 必須: SMSベースの確認、不正防止スクリーニング、B2Bフォーム。
• オプション: ラベル、プレースホルダー、必須切り替え。

住所

請求先または配送先住所を収集します。国別フィールドと自動入力機能を備えたStripeのスマート住所要素を表示します。

• 必須: 税金計算（自動税金は請求先住所が必要です）、配送処理、不正チェック。
• オプション：住所タイプ（請求先または配送先）、ラベル、必須トグル。

納税者番号

事業者の税識別番号（VAT、GST、ABN、EINなど）を収集し、請求書発行のためにStripe顧客に添付します。

• 必須：B2B EU請求書、リバースチャージVAT、レシートに税IDを印刷する必要がある事業者。
• オプション: ラベル、プレースホルダー、必須切り替え。

日付

日付ピッカーで日付値を収集します。

• 役立つ場面：イベント登録、予約、特定の日付への寄付、「希望配送日」など。
• オプション：ラベル、プレースホルダー、必須トグル、最小/最大日付の制約。
• 注：選択された値はフォームメタデータとして保存されます。請求金額やStripeの請求サイクルには影響しません。

---

支払い選択フィールド

価格セレクター

マルチプライスフォームで最も重要な支払いフィールド。顧客が支払いタブで定義した価格オプションから選択できるようにします。

• 表示スタイル：価格の表示方法を選択します：
  • 基本 — 通常のラジオボタンリスト（1〜3個の価格オプションがあるフォームのデフォルト）。
  • ドロップダウン — コンパクトな<select>要素。多くの価格があり、縦のスペースを節約したい場合に最適です。
  • リスト — タイトル、説明、価格が付いたカードのスタック。階層的な価格設定に最適です。
  • ボタン — 横並びのボタングループ。短いラベル形式のオプション（$10、$25、$50）に最適です。
• オプション：ラベル、デフォルト価格、必須トグル。

カスタム金額入力

顧客が自分で金額を入力できるようにします。「好きなだけ支払う」および寄付フォームの基盤となります。

• オプション：ラベル、プレースホルダー、最小金額、最大金額、デフォルト金額。
• ヒント：価格セレクターと組み合わせることで、推奨金額と「カスタム」オプションを提供できます。

クーポン

顧客がチェックアウト時にクーポンコードを適用できるようにします。クーポン自体はWP Simple Pay > クーポンで管理されます。 クーポンを追加および設定する方法を参照してください。

• オプション：ラベル、プレースホルダー。
• 注：グローバルなクーポン管理ページとは異なります。このフィールドは顧客向けの入力であり、管理ページはクーポンコードが作成される場所です。

定期金額トグル

顧客が有効にすると、同じフォームで1回限りの支払いを定期購読に変換するチェックボックスです。2つの別々のフォームを必要とせずに、「毎月寄付する」パターンを可能にします。

• オプション：ラベル、請求間隔（毎日/毎週/毎月/毎年）、請求限度。
• 必要：フォームでサブスクリプションが有効になっていること。

手数料回収トグル

顧客がStripeの取引手数料を任意で負担できるチェックボックスです。これにより、請求額が計算された金額だけ増加し、意図した全額を受け取ることができます。

• オプション：ラベル、手数料率、手数料固定額、デフォルト状態（チェックあり/なし）。
• 役立つ場面：非営利団体、寄付フォーム、B2B請求書。

金額の内訳

請求合計（明細、税金、手数料、クーポン、最終金額）を一覧表示する読み取り専用の表示フィールド。顧客が他のフィールドと対話するとリアルタイムで更新されます。

• 必須: 税金機能を使用して税金を徴収するフォーム。詳細は支払いにかかる税金の徴収方法を参照してください。このフィールドがないと、顧客は送信前に税金の明細項目を確認できません。
• オプション: ラベル、項目表示設定。

支払い方法

顧客がカード情報を入力したり、代替支払い方法（ACH、SEPA、Klarnaなど）を選択したり、保存済みの方法を選択したりするStripe Payment Elementを表示します。

• 表示タイプ: タブ（水平）またはアコーディオン（積み重ね） — 支払い方法の表示タイプの選択方法を参照してください。
• 表示項目数: アコーディオンを使用する場合、「その他」ボタンが表示される前に表示される方法の数を制御します。デフォルト: 5。
• 必須: すべてのオンサイト支払いフォーム。オフサイト（Stripe Checkout）フォームではこのフィールドは使用しません。

---

フォーム構造 / 表示フィールド

見出し

他のフィールドの間にスタイル設定された見出しを挿入します。関連フィールドのグループ化に便利です（「請求情報」、「イベント詳細」、「オプションの追加商品」）。

• オプション: 見出しテキスト、見出しレベル（H2～H6）。
• 注記: 純粋に視覚的なものです。値は収集されず、Stripeに送信されません。

テキスト

自由形式のHTML/テキスト用の複数行ブロック。指示、利用規約テキスト、マーケティングコピー、または感謝のコンテンツに使用します。

• オプション: 本文コンテンツ（HTML可）。
• 注記: 見出しと同様、これは表示目的のみです。

ドロップダウン

利用可能なオプションを定義する<select>要素。選択された値はフォームメタデータとして保存され、顧客レコードおよびStripeメタデータで表示できます。

• オプション: ラベル、オプションリスト（ラベル/値のペア）、デフォルト選択、必須トグル。
• 用途: 「どこで知りましたか？」、Tシャツのサイズ、イベントセッションの選択。

ラジオ選択

ドロップダウンと同じデータ形状ですが、<select>の代わりにラジオボタンで表示されます。オプションが2～5個あり、すべてを一度に表示したい場合に適しています。

• オプション: ラベル、オプションリスト、デフォルト選択、必須トグル。

---

送信トリガー

すべてのフォームには、これら2つのボタンフィールドのいずれか1つが必ず必要です。これらは相互に排他的です。フォームタイプ（一般タブで設定）によって、ピッカーに表示されるボタンが決まります。

支払いボタン

オンサイト支払いフォーム（埋め込みまたはオーバーレイ）の送信ボタン。同じページにあるStripe Payment Elementを使用して顧客に請求します。

• オプション: ボタンテキスト、処理中テキスト（リクエストが処理されている間に表示）。

チェックアウトボタン

オフサイトStripe Checkoutフォームの送信ボタン。顧客をStripeのホストされたチェックアウトページにリダイレクトします。

• オプション: ボタンテキスト、処理中テキスト。

よくある質問

一部のフォームに支払いボタンが表示され、他のフォームにチェックアウトボタンが表示されるのはなぜですか？

ボタンのタイプは、[全般]タブのフォームのタイプに紐づいています。オンサイトフォームは[支払いボタン]を使用し、オフサイト（Stripe Checkout）フォームは[チェックアウトボタン]を使用します。[全般]でタイプを変更すると、ボタンフィールドが自動的に切り替わります。

同じフィールドタイプを複数追加できますか？

一部のフィールドは複数回追加できます（見出し、テキスト、ドロップダウン、ラジオ選択、日付）。その他のフィールドは、固定の役割があるためフォームごとに1回しか使用できません — メールアドレス、価格選択、支払い方法、クーポン、送信ボタンはそれぞれ1つしか使用できません。ピッカーは既に使用されているフィールドをグレー表示します。

カスタムフィールドのデータはどこに行きますか？

カスタムフィールドの値は、StripeのPaymentIntentまたはSubscriptionのメタデータとして保存されます。Stripeダッシュボードの支払い記録のメタデータセクション、およびWP Simple Pay内の顧客記録で確認できます。データは、WebhookやUncanny Automatorなどのインテグレーションでも利用可能です（自動化タブの使用方法を参照）。

フィールドの値は領収書メールに含まれますか？

はい — スマートタグを使用して、カスタムフィールドの値を件名または本文に挿入できます。（スマートタグの使用を参照してください）。

金額内訳フィールドが空なのはなぜですか？

金額内訳には、現在のフォームに存在する品目のみが表示されます。フォームに税金、手数料、クーポンがなく、単一の価格オプションしかない場合、内訳は合計のみに折りたたまれます。項目化するものが「ある」場合に「生き生きと」表示されます。

フィールドの検証ルールをカスタマイズできますか？

組み込みフィールドは、適切なデフォルト（メールはメールとして検証され、税IDはStripeが受け入れる形式を受け入れますなど）を強制します。カスタム検証ロジックについては、simpay_form_validationフィルターを使用してください — ただし、ほとんどの場合は組み込みの必須トグルとフィールド固有のオプションで対応できます。

次にやること

• 支払いフォームのフィールドの設定とカスタムデータの収集方法 – フィールドの追加と並べ替えに関する一般的な説明
• 支払いに対する税金の徴収方法 – 住所フィールドと金額内訳フィールドを組み合わせて使用
• 支払い方法の表示タイプを選択する方法 – 支払い方法フィールドの設定