注文作成時に顧客のメールアドレスと氏名を送信しています。なぜチェックアウトはまだそれらの入力を求めるのですか？
貴社が送信した値の再利用は、デフォルトでオフのアカウントレベルの設定であり、項目ごとに設定されるためです。貴社アカウントで有効化されるまで、チェックアウトは貴社の値を決済用のデータとして扱い、顧客に表示し返すものとしては扱いません。 このように動作する理由：連携のかなりの割合が、プレースホルダーや合成の連絡先情報を送信しています。明らかに偽のメールアドレスを購入者に表示し返すことは、最悪のタイミングで信頼を損ねますし、そうした値の一部は下流でいずれにせよ却下されます。項目ごとのオプトインにより、それらが購入者の目に触れないようにしています。 再利用できる項目は次のとおりで、個別に選択します。
排他的な none オプションがあります。項目を列挙するか、何も再利用しないと宣言するかのどちらかです。「none」と項目リストを組み合わせることはできません。
first name にはフルネームが入ることに注意してください。last name なしで first name を送信した場合、last name は推測されるのではなく空のまま保存されます。
貴社アカウントでこの設定を変更するには、再利用したい項目のリストを添えて Waffo の担当者にお問い合わせください。
顧客が私の送信したメールアドレスを編集した場合、どちらの値が使われますか？
顧客の値です。購入者がチェックアウトページで変更した値は、その決済の残りの処理において、決済手段に渡される内容を含め、貴社が送信した値を置き換えます。これは意図的なものです。自分の連絡先を知っているのは購入者であり、住所を検証したり確認メールを送信する決済手段では、古い値を使うと決済が失敗してしまいます。 貴社の元の注文データは変更されません。元々何を送信したかを知る必要がある場合は、注文レコードを確認してください。リピーターの顧客は毎回すべてを入力し直す必要がありますか？
いいえ。2 つの別々の仕組みがあり、混同されやすいものです。チェックアウトが決済手段の選択ページをスキップするのはいつですか？
3 つのルールが、この順序で評価されます。
さらに、注文で
payMethodId を渡し、その決済手段が入力を必要とする場合、チェックアウトは選択ページではなくその決済手段のフォームを直接開きます。入力を必要としない payMethodId を渡した場合は、選択ページでそのグループが事前選択されます。
payMethodId が渡されない場合、事前選択されるのは、利用可能な決済手段を持つ最初のグループ内の最初に利用可能な決済手段です。利用できない決済手段が事前選択されることはありません。
カードフォームの正確な検証ルールは何ですか？
CVV の文字数は、カード番号からブランドが特定された時点でブランドに基づいて決まります。
したがって、番号が不完全な時点では受け付けられていた CVV が、ブランドが判明した時点で無効になることがあります。これは想定どおりの動作です。
複数の項目が間違っているのに、エラーメッセージが 1 つしか表示されないのはなぜですか？
各項目には最大 1 つのメッセージが表示されます。表示されるのは、必須 → 形式 → 短すぎる → 長すぎる の順で最初に違反したルールです。メッセージは項目が操作された後に表示されます。支払いボタンを押すとすべての項目が操作済みとしてマークされるため、送信時には違反した各項目にそれぞれ 1 つのメッセージが表示されます。 1 つだけ異なる動作をするケースがあります。**「This card is currently not supported」**は、入力中のカード番号に対してリアルタイムで評価されるため、フィールドを離れる前に表示されることがあります。しかしこれもカード番号フィールド上のメッセージであるため、番号自体の文字数や形式の問題が先に報告されます。番号を修正すると、残るのはカード非対応のメッセージです。 このメッセージは、フォームの形式が不正なのではなく、カード自体が対象外（種類、ブランド、発行地域が受け付けられない）であることを意味します。同じフィールドで表示される可能性のある関連コード：保存済みカードを持つ顧客には何が表示されますか？
注文でuserPaymentAccessToken を渡した場合、チェックアウトは短い完了ステップに直接進みます。カードはマスクされて表示され、顧客が入力する必要がある唯一の項目は CVV です。カード照会ステップは完全にスキップされるため、このページではキー入力ごとのカードチェックは行われません。
決済手段を指定しない場合、選択ページには、貴社アカウント下でその顧客に紐付けられているカードが、新しいカードを追加するオプションとともに一覧表示されます。各顧客は加盟店ごとに 1 枚のデフォルトカードを持つことができ、チェックアウトはそれを事前選択します。API を通じて、特定の注文で提示する保存済みカードを制限することもできます。
削除済みまたは期限切れのトークンは、黙って無視されるのではなく却下されます。コード 008001B113 は、カードが削除されたことを意味します。
顧客は次回のためにカードを保存することを選択できますか？
フォームには保存オプションが提示され、表示されるかどうかは決済手段と貴社アカウントによります。
注文からこれを制御することもできます。
paymentInfo.bindForFutureUse（0 = いいえ、1 = はい）は、その決済において決済手段を将来の利用のために紐付けることを要求します。黙って保存されることはありません。顧客はフォーム上でオプションを確認します。
保存されたカードがその後どこに表示され、後でどのように課金するかは、トークン化のドキュメントで扱っています。
注文で固定のカード番号プレフィックスを渡しています。フォームは変わりますか？
はい。注文でカード番号の先頭の数字が固定されている場合、チェックアウトはその数字を入力欄の前に編集不可のプレフィックスとして表示し、番号フィールドが受け付ける文字数は、すでに表示されている桁数分だけ短くなります。顧客は残りの部分だけを入力し、受け付けられる合計の文字数は変わりません。サンドボックスのチェックアウトにテストカードはありますか？
はい。サンドボックスでは、カードフォームのフィールドの上にクイック入力用のカードチップが表示され、クリックすると番号、有効期限、CVV、名義人が入力されます。これらはサンドボックス環境でのみ表示されます。本番環境でこれらを表示するコードパスは存在しないため、本番稼働前に何かをオフにする必要はありません。顧客は QR コードを保存して後で支払うことができますか？
いいえ。これは貴社自身のサポート用テンプレートに入れておく価値があります。- QR コードはその決済試行のみに有効です。再利用可能な支払先アドレスではなく、後の注文のために再提示することはできません。
- 注文が期限切れまたは成功した後は、チェックアウトリンクを再度開いても QR コードは一切表示されません。リンクは実際の注文状態に応じて失敗ページまたは成功ページに解決されます。
- QR コード画像を保存ボタンはモバイルのみで提供されます。デスクトップでは表示されません。デスクトップで保存されたスクリーンショットこそが、顧客に期限切れのコードで支払おうとさせる原因だからです。
チェックアウトページにエラーが表示されていますが、ぐるぐる回り続けています。止まっているのですか？
いいえ。それはリトライ可能な経路です。チェックアウトに届くすべてのエラーにはリトライ可能フラグが付いており、ページはそれぞれで異なる動作をします。
リトライ可能な経路では顧客が再送信する必要はなく、貴社がその上にクライアント側のリトライを構築するべきではありません。最終状態の正としては、ページがある時点で表示していた内容ではなく、決済通知または注文照会を扱ってください。
どのチェックアウトエラーコードを認識しておくべきですか？
完全なリストは長く、その大半はイシュアー起因です。以下は連携テストでよく出てくる、原因が貴社側または顧客側にあるものです。008001B03x〜008001B09x 範囲のコードは、ほぼすべてがイシュアーまたはウォレットの判断をそのまま中継したものです。顧客にはそのまま表示され、同じ決済手段でリトライしても成功に変えることはできません。
一部の決済で顧客にメールアドレスやメールの認証コードを求めるのはなぜですか？
特定の決済手段は、決済を受け付ける前に検証済みのメールアドレスを必要とするため、チェックアウトはそれを収集し、必要な場合はそのアドレスに送信されたワンタイムコードで検証します。これはルーティングされた決済手段の要件であり、Waffo が加盟店ごとに追加しているものではありません。 想定される動作：- 利用可能な
userInfo.userEmailを送信した場合、それがフィールドに事前入力されることがあります。一部の決済手段では、アドレスはその決済に対して固定され、顧客は置き換えることができません。この場合、同じステップで別のアドレスを送信すると却下されます。 - ワンタイムコードの有効期間は短いです。検証に成功すると、その注文において一定期間記憶されるため、顧客は決済を完了する間に検証を繰り返す必要はありません。
- このステップでのメールアドレスは 50 文字が上限です。
- 顧客がチェックアウトセッション内で決済手段を選択すると、その選択はそのセッションの間固定されます。
再現できない検証メッセージが表示されていますか？ 注文 ID、表示された正確なコード、顧客がモバイルかデスクトップかを添えて サポートにお問い合わせください。