注
Dynamics 365 Commerce の小売関連グループは、Yammer から Viva Engage に移行しました。 新しいViva Engage コミュニティにアクセスできない場合は、追加するフォーム (https://aka.ms/JoinD365commerceVivaEngageCommunity) に入力し、最新のディスカッションに参加してください。
この記事では、Microsoft Dynamics 365 Commerce の支払いソフトウェア開発キット (SDK) が、お客様が支払いターミナルから入力するチップ金額をサポートする方法について説明します。 この機能の目的は、承認の応答にチップ金額のフィールドを個別に含めることによって、支払 SDK にファーストクラスのサポートを追加することです。
この機能は、POSシステムでのチップやチップレポートのサポートを追加するものではありません。 完全なチップ機能を実装するには、POS 拡張機能が必要です。
重要な用語
| 用語 | 説明 |
|---|---|
| ヒント | チップは、チップとも呼ばれ、簡易サービス業界やホスピタリティ業界では一般的です。 これにより、サービスを提供する店舗またはレストランの従業員に対して直接支払を行うことができます。 |
| ヘッダーレベルの請求金額 | 購入に適用できる料金ですが、特定の品目に対しては適用されません。 |
チップ機能の概要
チップは、一部のロケールおよび業界では一般的です。 たとえば、ファストサービスとホスピタリティ業界では、アメリカのほぼすべての場所でチップが渡されるのが一般的です。 多くの企業にとって、支払ターミナルを介したチップをサポートする機能は、従業員を引き付けるのに役立つ重要な要素になりつつあります。 この機能では、支払い SDK に個別の TipAmount フィールドが追加されるため、顧客が支払いターミナルで選択したチップ金額を承認応答の一部として POS に返送できます。
この機能は、支払 SDK のレベルでのチップのサポートを追加しますが、チップ機能の他の重要な側面のサポートは含まれていません。 たとえば、この機能は、シフト終了時のチップ支払いのレポート、チップをプールする機能、または給与のチップをレポートする機能をサポートしていません。 完全なチップ サポートを有効にするには、拡張機能を介してこれらの機能を実装する必要があります。
この記事で説明されている支払ターミナル統合と SDK 参照を作成する方法の詳細については、支払ターミナルの支払統合全体の作成を参照してください。
必要条件
| 前提条件 | 説明 |
|---|---|
| デバイス上のヒントサポート | 顧客は、支払ターミナルでチップ金額を選択できる必要があります。 |
| isTippingEnabled サポート | 支払いコネクタは、支払いの初期化のために isTippingEnabled 変数をサポートする必要があります。 |
| TipAmount フィールド | チップ金額は、承認応答の TipAmount フィールドの支払いコネクタから返される必要があります。 |
| 拡張機能を通じた POS チップ機能のサポート | 支払コネクタが返すチップ金額は、ヘッダー レベルの料金として販売に追加する必要があります。 チップのレポートおよび管理は、そのままでは提供されません。 |
支払プロセッサによるチップのサポート
この機能は、新しい isTippingEnabled 変数を AuthorizePaymentTerminalDeviceRequest リクエストに追加します。 POS から支払いが要求されると、この変数は、承認要求がチップを追加する資格があるかどうかを示します。 このリクエストを受信した支払コネクタは、接続された支払サービスまたはターミナルからチップ適格承認をリクエストできます。
isTippingEnabled 変数が True に設定されている場合、顧客が支払いターミナルでチップ金額を選択した場合、支払コネクタは AuthorizePaymentCardPaymentResponse 応答の TipAmount フィールドでその金額を返します。 チップ金額は、承認応答の ApprovedAmount フィールドにも含まれています。
Adyen コネクタのチップ サポート
Adyen コネクタにはチップ サポートが含まれています。 承認応答がコネクターに渡されるときに isTippingEnabled 変数を True に設定するには、カスタマイズが必要です。 isTippingEnabled 変数が True に設定されている場合、顧客がデバイスのチップ金額を選択した場合、支払コネクタは承認応答の TipAmount フィールドにその金額を返します。
顧客が Adyen ターミナルでチップの金額を選択するように求められる前に、ターミナルはチップ用に構成されている必要があります。 Adyen の顧客領域でこの設定を構成します。 チップを有効にするには、Adyen ポータルの販売時点管理タブを選択します。 ターミナルまたはフリート全体の ターミナル設定 オプションを使用して、チップを有効にすることができます。 個々のターミナルの設定とフリート全体のターミナル設定の両方で、[ 支払い機能 ] タブでチップを有効にします。Adyen デバイスでチップを有効にした後、デバイスの設定を更新します。 この変更は、この更新が完了するまで有効になりません。
推奨される実装
ヘッダー レベルの料金を使用して、承認応答が支払いコネクタから返された後に、チップ金額をトランザクションに追加します。 この機能をサポートするには、 PaymentTerminalAuthorizePaymentRequestHandler ハンドラーの拡張機能を作成します。 承認応答で TipAmount 値が返された場合に、ヘッダー レベルの料金をトランザクションに追加するロジックを拡張機能に含めます。