Visa スポーク
ServiceNow インスタンスを Visa スポークと統合して、Visa カード異議申し立てプロセスのための Visa Resolve Online (VROL) で Visa API をシームレスに呼び出します。スポークを使用して、トランザクションの検索、マーチャントとのコラボレーション、異議申し立ての管理、セキュリティが強化されたその他の機能を実行できます。
統合ハブサブスクリプション
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。
スポークバージョン
Visa スポーク v1.2.0 が最新バージョンです。
主要な機能
この機能には、VROL (Visa Resolve Online) を介して Visa API を呼び出し、エンドツーエンドのカード異議申し立てプロセスを管理するアクションの作成が含まれています。これには、次のようなタスクがあります。
- 拡張トランザクション情報の取得
- トランザクション検索の実行
- 異議申し立てケースの作成の開始
- Visa アンケートの送信
- 既存の異議申し立てケースの事前仲裁および仲裁の開始
スポークの要件
統合ハブサブスクリプション
スポークの依存関係
これらの依存プラグインがインストールされていることを確認します。
- ServiceNow 統合ハブ ランタイム (com.glide.hub.integration.runtime)
- ServiceNow 統合ハブ アクションステップ - REST (com.glide.hub.action_step.rest)
注:
これらのプラグインの一部はライセンス可能な機能であり、スポーク実装の外部で使用する場合は適切なライセンスが必要です。
スポークのアクション
Visa スポークは、VROL (Visa Resolve Online) で Visa API を呼び出して、カード異議申し立てプロセス全体を管理するアクションを提供します。使用可能なアクションは次のとおりです。
- 機密情報を含むアクション：これらのアクションには、要求と応答の本文に機密情報が含まれています。これらの VROL API を呼び出すときは、トークン化ソリューションを使用する必要があります。重要:個人識別可能情報 (PII) データを含む、Visa API のフロー実行ログを無効にする必要があります。これを行うには、システムプロパティの com.snc.process_flow.reporting.level プロパティをオフに設定する必要があります。
表 : 1. 機密情報を含むアクション カテゴリ アクション 説明 注文インサイトデジタル管理 カード名義人の購入問い合わせ (要求ビルダー) CardholderPurchaseInquiry の要求ペイロードを生成します。この API は、リアルタイムシステムインターフェイス (RTSI) ユーザーに、トランザクションに関する追加のマーチャント情報を要求する機能を提供します。また、VisaNet 以外の取引の購入情報を取得する場合にも使用できます。 カード名義人の購入問い合わせ (応答パーサー) CardholderPurchaseInquiry の応答を解析します。この API は、リアルタイムシステムインターフェイス (RTSI) ユーザーに、トランザクションに関する追加のマーチャント情報を要求する機能を提供します。また、VisaNet 以外の取引の購入情報を取得する場合にも使用できます。 トランザクション照会管理 すべてのトランザクションの詳細を検索 (要求ビルダー) ユーザーが、ユーザーの組織のすべてのスケジュール済みレポート、またはユーザーが知りたい特定のレポートの詳細を取得できるようにします。 すべてのトランザクションの詳細を検索 (応答パーサー) getAllTransDetails の応答を解析します。発行者は、この API を使用して、検索パラメーターとして 1〜10 個の VisaNet トランザクション ID を使用するトランザクションの完全なトランザクションの詳細を取得する別の方法を使用できます。 ケース要求ビルダーからトランザクションの詳細を検索 getTransactionsFromCase の要求ペイロードを生成します。発行者はこの API を使用して、ケースの「選択された」トランザクションの TI の詳細を取得できます。つまり、異議が申し立てられている元のトランザクションです。また、TI 検索から返された「選択済された」トランザクションと「選択されていない」トランザクションのサマリーも返し、ケースと共に保存されます。 ケース応答パーサーからトランザクションの詳細を検索 getTransactionsFromCase の応答を解析します。発行者はこの API を使用して、ケースの「選択された」トランザクションの TI の詳細を取得できます。つまり、異議が申し立てられている元のトランザクションです。また、TI 検索から返された「選択済された」トランザクションと「選択されていない」トランザクションのサマリーも返し、ケースと共に保存されます。 トランザクションの詳細を検索 (要求ビルダー) getTransDetails の要求ペイロードを生成します。発行者は、この API を使用して、返されたトランザクションの詳細レベルのデータを取得できます。 トランザクションの詳細を検索 (応答パーサー) getTransDetails の応答を解析します。発行者は、この API を使用して、返されたトランザクションの詳細レベルのデータを取得できます。 トランザクション照会結果を検索 (要求ビルダー) getTransInquiryResults の要求ペイロードを生成します。これにより、トランザクション照会 (TI) イベント ID が受け入れられ、トランザクションのサマリー情報が返されます。 トランザクション照会結果を検索 (応答パーサー) getTransInquiryResults の応答を解析します。これにより、トランザクション照会 (TI) イベント ID が受け入れられ、トランザクションのサマリー情報が返されます。 複数のトランザクション照会を送信 (要求ビルダー) submitMultiTranInquiry の要求ペイロードを生成します。これにより、検索パラメーターとして 1〜10 個の VisaNet トランザクション ID を使用してトランザクションを検索する別の方法が提供されます。 複数のトランザクション照会を送信 (応答パーサー) submitMultiTranInquiry の応答を解析します。これにより、検索パラメーターとして 1〜10 個の VisaNet トランザクション ID を使用してトランザクションを検索する別の方法が提供されます。 トランザクション照会を送信 (要求ビルダー) submitTranInquiry の要求ペイロードを生成します。このアクションは、一連の検索条件を使用してトランザクションを検索するために使用されます。 トランザクション照会を送信 (応答パーサー) submitTranInquiry の要求ペイロードを生成します。このアクションは、一連の検索条件を使用してトランザクションを検索するために使用されます。 不正行為レポート管理 不正行為レポートを送信 (要求ビルダー) SubmitFraudReport の要求ペイロードを生成します。この API を使用すると、ユーザーは、インターフェイス要素スプレッドシート (IES) に記載されている必要なすべての不正データを含む不正行為レポートを Visa Resolve Online (VROL) に送信できます。 不正行為レポートを送信 (応答パーサー) SubmitFraudReport の応答を解析します。この API を使用すると、ユーザーは、インターフェイス要素スプレッドシート (IES) に記載されている必要なすべての不正データを含む不正行為レポートを Visa Resolve Online (VROL) に送信できます。 異議申し立て届出詳細を検索 (要求ビルダー) このアクションは、API getDisputeFilingDetails の入力ペイロードをビルドします。 異議申し立て届出の詳細を検索 (応答パーサー) getDisputeFilingDetails の応答を解析します。getDisputeFilingDetails は、異議申し立ての届出を含むメッセージと、異議申し立ての届出アイテムタイプとともに画像の詳細を取得するために使用されます。 不正行為レポートの詳細を検索 (要求ビルダー) ユーザーが以前に送信された不正行為レポートに関する追加情報をリアルタイムで要求できるようにします。 不正行為レポートの詳細を検索 (応答パーサー) このアクションは、不正行為レポートの詳細取得 API を呼び出した後に、VROL システムによって返された応答本文を解析します。 異議申し立て財務管理 異議申し立て財務アドバイスの詳細を検索 (要求ビルダー) GetDisputeFinancialAdviceDetails API の要求ペイロードを生成します。これにより、リアルタイムシステムインターフェイス (RTSI) ユーザーは、異議申し立ての財務アドバイスデータを要求できます。 異議申し立ての財務アドバイスの詳細を検索 (応答パーサー) GetDisputeFinancialAdviceDetails API の応答を解析します。これにより、リアルタイムシステムインターフェイス (RTSI) ユーザーは、異議申し立ての財務アドバイスデータを要求できます。 異議申し立て財務の詳細を検索 (要求ビルダー) GetDisputeFinancialDetails API の要求ペイロードを生成します。この API は、取得者または発行者のケースにおける異議申し立ての財務詳細を取得します。 異議申し立ての財務の詳細を検索 (応答パーサー) GetDisputeFinancialDetails API の応答を解析します。この API は、取得者または発行者のケースにおける異議申し立ての財務詳細を取得します。 ケース管理 手動ケース作成を送信 (要求ビルダー) SubmitFraudReport の応答を解析します。この API を使用すると、ユーザーは、インターフェイス要素スプレッドシート (IES) に記載されている必要なすべての不正データを含む不正行為レポートを Visa Resolve Online (VROL) に送信できます。 手動ケース作成を送信 (応答パーサー) SubmitManualCaseCreation API の要求ペイロードを生成します。これにより、ユーザーはトランザクションなしでケースを作成できます。 ケースの詳細を検索 (要求ビルダー) GetCaseDetails の要求ペイロードを生成します。この API を使用すると、ユーザーは VisaCaseNumber と MemberRole を指定するときに、トランザクション情報、異議申し立て管轄、ケースタイプ、その他のケース関連フィールドなど、特定の VROL ケースの詳細を要求できます。応答で返される情報は、要求を行うユーザーのロール、およびケースが現在どのステージとステータスにあるかによって異なります。 ケースの詳細を検索 (応答パーサー) GetCaseDetails の応答を解析します。この API を使用すると、ユーザーは VisaCaseNumber と MemberRole を指定するときに、トランザクション情報、異議申し立て管轄、ケースタイプ、その他のケース関連フィールドなど、特定の VROL ケースの詳細を要求できます。応答で返される情報は、要求を行うユーザーのロール、およびケースが現在どのステージとステータスにあるかによって異なります。 アンケート管理 承認通知の詳細を検索 (要求ビルダー) GetAcceptanceNotificationDetails の要求ペイロードを生成します。この API は、リアルタイムシステムインターフェイス (RTSI) ユーザーに、承認されてクローズされた異議申し立てまたは異議申し立て応答の承認通知の詳細を取得する機能を提供します。 承認通知の詳細を検索 (応答パーサー) GetAcceptanceNotificationDetails の応答を解析します。この API は、リアルタイムシステムインターフェイス (RTSI) ユーザーに、承認されてクローズされた異議申し立てまたは異議申し立て応答の承認通知の詳細を取得する機能を提供します。 異議申し立て詳細を検索 (要求ビルダー) getDisputeDetails の要求ペイロードを生成します。発行者は、この API を使用して、異議申し立てのアンケートデータを画像形式および XML で返送するよう要求します。 異議申し立ての詳細を検索 (応答パーサー) getDisputeDetails の応答を解析します。発行者は、この API を使用して、異議申し立てのアンケートデータを画像形式および XML で返送するよう要求します。 異議申し立て応答の詳細を検索 (要求ビルダー) GetDisputePreArbResponseDetails の要求ペイロードを生成します。この API を使用すると、リアルタイムシステムインターフェイス (RTSI) ユーザーは、事前調停応答のアンケートデータを画像形式および XML で返送するよう要求できます。 異議申し立て応答の詳細を検索 (応答パーサー) GetDisputePreArbResponseDetails の要求ペイロードを生成します。この API を使用すると、リアルタイムシステムインターフェイス (RTSI) ユーザーは、事前調停応答のアンケートデータを画像形式および XML で返送するよう要求できます。 キュー管理 キュー要求ビルダーを検索 GetQueue API の要求ペイロードを生成します。この API は、受信コラボレーションキュー、却下された異議申し立てフォームなど、異議申し立てのライフサイクル中に指定されたキューに関する情報を取得します。 キューを検索 (応答パーサー) GetQueue API の応答を解析します。この API は、受信コラボレーションキュー、却下された異議申し立てフォームなど、異議申し立てのライフサイクル中に指定されたキューに関する情報を取得します。 ケース届出管理 連絡先メッセージ詳細を検索 (要求ビルダー) GetContactMessageDetails の要求ペイロードを生成します。この API は、リアルタイムシステムインターフェイス (RTSI) ユーザーに、連絡先メッセージのアンケートデータを画像形式と XML で返すように要求する機能を提供します。 連絡先メッセージ詳細を検索 (応答パーサー) GetContactMessageDetails の応答を解析します。この API は、リアルタイムシステムインターフェイス (RTSI) ユーザーに、連絡先メッセージのアンケートデータを画像形式と XML で返すように要求する機能を提供します。返される画像は TIFF または PDF 形式になります。異議申し立てを画像として取得するには、ユーザーが <IncludeDisputeAsImageInd>=true w と設定する必要があります。 連絡先メッセージ応答詳細を検索 (要求ビルダー) getContactMessageResponseDetails の要求ペイロードを生成します。このアクションにより、リアルタイムシステムインターフェイス (RTSI) ユーザーは、連絡先メッセージ応答の詳細を取得できます。 連絡先メッセージ応答の詳細を検索 (応答パーサー) getContactMessageResponseDetails の応答を解析します。このアクションにより、リアルタイムシステムインターフェイス (RTSI) ユーザーは、連絡先メッセージ応答の詳細を取得できます。 HyperSearch 要求管理 HyperSearch 要求ビルダー HyperSearch の要求ペイロードを生成します。この API はケース一致パラメーターを受け取り、見つかったすべてのケースに関する情報を返します。 HyperSearch 応答パーサー HyperSearch の応答を解析します。この API はケース一致パラメーターを受け取り、見つかったすべてのケースに関する情報を返します。 バッチキュー管理 バッチキュー要求ビルダーを検索 GetBatchQueue API の要求ペイロードを生成します。この API は、指定された RTSI バッチキューからトランザクションを取得します。 バッチキューを検索 (応答パーサー) GetBatchQueue API の応答を解析します。この API は、指定された RTSI バッチキューからトランザクションを取得します。 バッチキュー管理 バッチキュー要求ビルダーを検索 GetBatchQueue API の要求ペイロードを生成します。この API は、指定された RTSI バッチキューからトランザクションを取得します。 バッチキューを検索 (応答パーサー) GetBatchQueue API の応答を解析します。この API は、指定された RTSI バッチキューからトランザクションを取得します。 異議申し立て事前調停管理 異議申し立て事前調停応答の詳細を検索 (要求ビルダー) GetDisputePreArbResponseDetails の応答を解析します。この API を使用すると、リアルタイムシステムインターフェイス (RTSI) ユーザーは、事前調停応答のアンケートデータを画像形式および XML で返送するよう要求できます。返される画像は TIFF または PDF 形式になります。異議申し立てを画像として取得するには、ユーザーが <IncludeDisputeAsImageInd>=true w と設定する必要があります。画像データは、SIGetDisputePreArbResponseDetailsResponse の <Image> グループに返されます 異議申し立て事前調停の詳細応答を検索 (応答パーサー) GetDisputePreArbResponseDetails の要求ペイロードを生成します。この API を使用すると、リアルタイムシステムインターフェイス (RTSI) ユーザーは、事前調停応答のアンケートデータを画像形式および XML で返送するよう要求できます。 異議申し立て事前調停の詳細を検索 (要求ビルダー) GetDisputePreArbDetails API の要求ペイロードを生成します。事前調停のアンケートデータを画像形式および XML で返送するよう要求します。 異議申し立て事前調停の詳細を検索 (応答パーサー) GetDisputePreArbDetails API の応答を解析します。事前調停のアンケートデータを画像形式および XML で返送するよう要求します。 例外ファイルリスト管理 照会例外を検索 (要求ビルダー) このアクションは、例外について照会する API の要求ペイロードをビルドします。 照会例外を検索 (応答パーサー) このアクションは、照会例外の検索 API を呼び出した後に、VROL システムによって返された応答本文を解析します。 例外の詳細を検索 (要求ビルダー) このアクションは、API getExceptionDetails の要求ペイロードをビルドします。 例外の詳細を検索 (応答パーサー) このアクションは、getExceptionDetails API を呼び出した後に、VROL システムによって返された応答本文を解析します。 例外要求ビルダーを送信 submitException の要求ペイロードを生成します。発行者は submitExceptionRequest を使用して、新規または既存のケースの例外ファイルリストを追加、更新、または削除することができます。また、拒否された例外ファイルリストを修復するためにも使用されます。 例外応答パーサーを送信 submitException の応答を解析します。発行者は submitExceptionRequest を使用して、新規または既存のケースの例外ファイルリストを追加、更新、または削除することができます。また、拒否された例外ファイルリストを修復するためにも使用されます。 雑費管理 雑費の詳細を検索 (要求ビルダー) getMiscFeeDetails の要求ペイロードを生成します。GetMiscFeeDetailsRequest を使用すると、クライアントは雑費の詳細を要求できます。 雑費の詳細を検索 (応答パーサー) getMiscFeeDetailsRequest の応答を解析します。GetMiscFeeDetailsRequest を使用すると、クライアントは雑費の詳細を要求できます。 雑費を送信 (要求ビルダー) SubmitMiscFee API の要求ペイロードを生成します。これにより、クライアントはデータを使用して雑費を要求できます。 雑費を送信 (応答パーサー) SubmitMiscFee API の応答を解析します。これにより、クライアントはデータを使用して雑費を要求できます。 不正行為監視プログラム管理 GMFP の詳細を検索 (要求ビルダー) このアクションは、API GetGMFPDetails の要求ペイロードをビルドします。 GMFP の詳細を検索 (応答パーサー) このアクションは、GMFP の詳細 API を呼び出した後に、VROL システムによって返された応答本文を解析します。 - 機密でない情報を含むアクション - これらの Visa API を ServiceNow インスタンスから直接呼び出すことができます。
表 : 2. 機密でない情報を含むアクション カテゴリ アクション 説明 異議申し立て財務管理 トランザクションまたはケースから異議申し立てを開始 ユーザーがトランザクションまたはケースから異議申し立てを開始できるようにします。 異議申し立てステータスを変更 CardholderPurchaseInquiry の応答を解析します。この API は、リアルタイムシステムインターフェイス (RTSI) ユーザーに、トランザクションに関する追加のマーチャント情報を要求する機能を提供します。また、VisaNet 以外の取引の購入情報を取得する場合にも使用できます。 ケース管理 画像を検索 新しく作成されたケースに追加された画像を取得します。 画像をアップロード UploadImage は、ケースに画像を追加するために使用されます。 画像をダウンロードして添付 Visa ケース画像をダウンロードして ServiceNow レコードに添付します。 ケース解決ステータスの更新 ユーザーがケースのケース解決ステータスを更新できるようにします。これにより、行われたステータス変更によっては、ケースがクローズする場合があります。 トランザクションからケースを作成 発行者はこの API を使用して、トランザクション照会要求からケースを作成します。 アンケート管理 異議申し立てアンケートの送信 このアクションにより、リアルタイムシステムインターフェイス (RTSI) ユーザーは異議申し立てアンケートを送信または保存できます。 不正行為バンドル異議申し立てアンケートステータスを検索 送信された不正行為バンドル異議申し立ての詳細を取得する機能をリアルタイムシステムインターフェイス (RTSI) ユーザーに提供します。 不正行為バンドル異議申し立てアンケートを送信 リアルタイムシステムインターフェイス (RTSI) ユーザーに、不正バンドル異議申し立てアンケートを送信または保存する機能を提供します。この要求には画像を含めることができます。 バッチキュー管理 バッチキューアイテムを既読としてマーク トランザクションを読み取りとしてマークし、リアルタイムシステムインターフェイス (RTSI) バッチキューから削除します。 キュー管理 GMFP を無視 発行者がキュー内の各 Visa 不正行為監視プログラム (VFMP) トランザクションを確認した後、GMFPItemID を使用して要求を送信することで、VFMP トランザクションのステータスを [無視] に変更できるようにします。 雑費のクローズ 雑費トランザクションを削除する機能を提供します。 メッセージを閉じる 投稿証明要求 (RPP) メッセージトランザクションを削除する機能を提供します。 異議申し立てを受諾 異議申し立て責任を受け入れるか、相手側の決定を受け入れて、異議申し立てトランザクションをキューから削除します。 トランザクション照会管理 トランザクションのクローズ このアクションは、特定のトランザクションをクローズし、それぞれのキューから削除するために使用されます。 関連トランザクションを選択 AssociatedTranSelection を使用すると、ユーザーは、グループ内の関連付けられたトランザクションの一部またはすべての関連付けを、ケース内の選択したトランザクションで確認または反論できます。 関連トランザクションリストを検索 ユーザーが関連トランザクショングループ ID を指定して、関連トランザクションのリストを取得できるようにします。 関連トランザクション選択を検索 ユーザーは、グループ内の関連付けられたトランザクションの一部またはすべての関連付けを、ケース内の選択したトランザクションで確認または反論できます。 異議申し立て事前調停管理 異議申し立て事前調停を作成 この API を使用して事前調停の作成を開始します。 異議申し立て事前調停の応答を作成 リアルタイムシステムインターフェイス (RTSI) ユーザーに事前調停に応答する機能を提供します。 ケース届出管理 連絡先メッセージ応答を送信 SubmitContactMessageResponse を使用すると、リアルタイムシステムインターフェイス (RTSI) ユーザーは連絡先メッセージへの応答を送信できます。 異議申し立て届出を送信 異議申し立て要求、取り下げ、または要請を送信します。 レポート配布管理 レポート出力を検索 ユーザーが特定の実行日のレポートを CSV 形式で取得できるようにします。 アクティブなスケジュールを検索 ユーザーが、ユーザーの組織のすべてのスケジュール済みレポート、またはユーザーが知りたい特定のレポートの詳細を取得できるようにします。 バッチキュー管理 バッチキューアイテムを既読としてマーク トランザクションを読み取りとしてマークし、リアルタイムシステムインターフェイス (RTSI) バッチキューから削除します。
接続および資格情報エイリアスの要件
統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。
スポークの設定の詳細については、「Visa スポークのセットアップ」を参照してください。