Mastercard スポーク

ストアでアプリを要求する

ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

統合ハブサブスクリプション

このスポークには統合ハブのサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照してください。

スポークバージョン

Mastercard スポーク v2.0.1 が最新バージョンです。

サポートされているバージョン

このスポークは Mastercom v6 用にビルドされました。

主要な機能

Mastercard スポークを使用すると、フローデザイナーは Mastercom 、および Mastercom Extended. これには、次の機能が含まれます。

トランザクションの検索
請求とチャージバックの作成
マーチャントとの連携によるチャージバックの防止
異議申し立てライフサイクル全体にわたる異議申し立ての監視
エンドツーエンドの異議申し立て管理プロセスの迅速化
との清算済み単一メッセージシステムの元のトランザクションの異議申し立ての管理 Mastercom Extended

スポークの要件

統合ハブサブスクリプション
Mastercard 証明書、キーエイリアス、コンシューマーキー、キーストアパスワードなどの構成の詳細

スポークの依存関係

これらの依存プラグインがインストールされていることを確認します。

ServiceNow 統合ハブランタイム (com.glide.hub.integration.runtime)
ServiceNow 統合ハブアクションステップ - REST (com.glide.hub.action_step.rest)

注:

これらのプラグインの一部はライセンス可能な機能であり、スポーク実装の外部で使用する場合は適切なライセンスが必要です。

スポークのアクション

Mastercard スポークは、カード異議申し立ての解決を簡素化するアクションを提供します。使用可能なアクションは次のとおりです。

機密情報を含むアクション：これらのアクションには、要求と応答の本文に機密情報が含まれています。Mastercom/Mastercom Extended API を使用する場合は、トークン化ソリューションを使用することをお勧めします。これには、リクエストを安全に作成するためのリクエストビルダーと、暗号化された API 応答を処理するためのレスポンスパーサーの使用が含まれます。

表 : 1. Mastercom 機密情報を含む操作
カテゴリ	アクション	説明
トランザクション	トランザクション承認の詳細を検索 (要求ビルダー)	発行者が請求を作成した後、請求に含まれる元のトランザクションの承認の詳細を発行者が検索できるようにします。
	トランザクション承認の詳細を検索 (応答パーサー)	発行者が請求を作成した後、請求に含まれる元のトランザクションの承認の詳細を発行者が検索できるようにします。
	トランザクションの清算の詳細を検索 (要求ビルダー)	発行者が、請求に含まれる元のトランザクションの清算の詳細を取得できるようにします。取得者がこれを使用して、元のトランザクションに関連付けられた清算の詳細を取得することもできます。
	トランザクションの清算の詳細を検索 (応答パーサー)
	トランザクションを検索 (要求ビルダー)	発行者が元のトランザクションに関する情報を検索できるようにします。発行者はこの情報を使用して、元のトランザクションに対して、請求の作成などのアクションを実行できます。
	トランザクションを検索 (応答パーサー)
クレーム	キュー内の請求を検索 (要求ビルダー)	発行者が、日付間隔要求ビルダー内のキューの請求のリストを取得できるようにします。
	キュー内の請求を検索 (応答パーサー)	発行者が、日付間隔要求ビルダー内のキューの請求のリストを取得できるようにします。
	請求 ID で請求の詳細を検索 (要求ビルダー)	発行者と取得者が、請求が関連付けられているケースを含む既存の請求の詳細を取得できるようにします。
	請求 ID で請求の詳細を検索 (応答パーサー)	発行者と取得者が、請求が関連付けられているケースを含む既存の請求の詳細を取得できるようにします。

表 : 2. Mastercom Extended 機密情報を含むアクション
カテゴリ	アクション	説明
Mastercom Extended - 請求管理	ID で請求の詳細を検索 (要求ビルダー):拡張	要求ビルダーは、このアクションの要求ペイロードを生成します。このエンドポイントを使用して、既存の請求の詳細を取得します。
	ID で請求の詳細を検索 (応答パーサー):拡張	検索からの応答を解析します。このエンドポイントを使用して、既存の請求の詳細を取得します。
	請求の詳細を検索 (要求ビルダー):拡張	要求ビルダーは、このアクションの要求ペイロードを生成します。このエンドポイントを使用して、請求のリストを取得します。
	請求の詳細を検索 (応答パーサー):拡張	searchClaim の応答を解析します。このエンドポイントを使用して、請求のリストを取得します。
Mastercom Extended - 取引管理	トランザクションを検索 (要求ビルダー):拡張	要求ビルダーは、このアクションの要求ペイロードを生成します。このエンドポイントを使用して、トランザクションを検索します。
Mastercom Extended - 取引管理	トランザクションを検索 (応答パーサー):拡張	検索からの応答を解析します。このエンドポイントを使用して、トランザクションを検索します。
Mastercom Extended - ケースファイリングドキュメント管理	ケース ID で処理済みドキュメントを検索 (要求ビルダー:拡張済み)	ケース API に関連付けられた処理済みドキュメントを取得するための要求ビルダー。このエンドポイントを使用して、ケースからすべてのドキュメントを取得します。ドキュメントには、任意の当事者が添付したドキュメントが含まれます。
Mastercom Extended - ケースファイリングドキュメント管理	ケース ID で処理済みドキュメントを検索 (応答パーサー):拡張	ケースに関連付けられた処理済みドキュメントの取得の応答を解析します。このエンドポイントを使用して、ケースからすべてのドキュメントを取得します。ドキュメントには、送信者、受信者、またはその両方が添付したドキュメントが含まれます。
Mastercom Extended - ドキュメント管理	ドキュメント完了 ID で処理済みドキュメントを検索 (要求ビルダー:拡張済み)	処理済みドキュメントを取得 API の要求ビルダー。このエンドポイントを使用して、処理されたドキュメントを取得します。
Mastercom Extended - ドキュメント管理	ドキュメント完了 ID で処理済みドキュメントを検索 (応答パーサー:拡張)	Retrieve processed documents API エンドポイントの応答パーサー。このエンドポイントを使用して、処理されたドキュメントを取得します。

次の例は、トークン化ソリューションと統合する場合のソリューションの概要を示します：トークン化ソリューションの概要。

機密でない情報を含むアクション - ServiceNow インスタンスからこれらの Mastercom/Mastercom Extended API を直接呼び出すことができます。

表 : 3. Mastercom 機密情報含むアクション
カテゴリ	アクション	説明
Mastercom チャージバック管理	チャージバックを確認	チャージバックまたは 2 回目のプレゼントメントを確認すると、請求が未処理キューから作業済みキューに移ります。
	チャージバックを作成	サポートドキュメントをアップロードするオプション付きで、チャージバックと 2 回目のプレゼントメントを作成します。
	チャージバックのデータをロード	チャージバックを作成する前に、考えられる最初のチャージバックまたは 2 回目のプレゼントメントに関する情報を取得します。
	チャージバックドキュメントをルックアップ	チャージバックタイプに関連付けられた必要な形式でドキュメントを取得します。
	チャージバックイメージステータスをルックアップ	チャージバックについて、ステータス (完了、保留中、失敗、利用不可、または該当ドキュメントなし) のドキュメントを取得します。
	チャージバックのステータスを検索	請求 ID とチャージバック ID の特定のリストでドキュメントステータスを取得します。注: 発行者と取得者は、1 回の要求で最大 2,000 のチャージバック ID を送信できます。
	チャージバックを取り消す	発行者または取得者がエラーでチャージバックを作成したときに、既存のチャージバックを取り消します。
	チャージバックを更新	既存のチャージバックをメモまたはドキュメント付きで更新します。
Mastercom 請求管理	要求を作成	このエンドポイントを使用して回収要求または最初のチャージバックを作成する前に必要な請求を作成します。
Mastercom 請求管理	既存の請求に対するアクションを実行	このエンドポイント使用して、既存の請求に対する操作 (再開または完了) を実行します。
Mastercom 不正管理	不正アイテムを作成	発行者がトランザクションは不正だったと判断した場合に不正アイテムを作成します。注: Mastercom を使用すると、発行者は不正および損失データベースに不正アイテムを作成できます。ただし、発行者が不正アイテムをさらに更新するには、不正および損失アプリケーションを使用する必要があります。
Mastercom 不正管理	不正関連情報をルックアップ	このエンドポイント使用して、請求の不正アイテムを作成する前に、請求に関連付けられた不正関連情報を取得します。
Mastercom キュー管理	キュー名をルックアップ	キュー名のリストを取得します。

表 : 4. Mastercom Extended 機密でない情報を含むアクション
カテゴリ	アクション	説明
Mastercom Extended - ケースファイリングドキュメント管理	ケース ID でドキュメントを添付:拡張	このエンドポイントを使用して、前のドキュメントの処理に失敗したときに、既存のケースに新しいドキュメントを添付します。ドキュメント処理ステータスは、GET /cases/documents/attributes エンドポイントから取得できます。
Mastercom Extended - ケースファイリングドキュメント管理	ケースに関連付けられたドキュメントのステータスを検索:拡張	このエンドポイントを使用して、ケースに関連付けられたドキュメントの処理ステータスを取得します。
Mastercom Extended - ケースファイリング管理	事前調停/仲裁ケースの作成:拡張	このエンドポイントを使用して、事前調停または調停ケースを作成します。
	ID でケースの詳細を検索:拡張	このエンドポイントを使用して既存のケースの詳細を取得し、ケースに関する包括的な情報を提供します。
	事前調停/仲裁ケースの更新:拡張	このエンドポイントを使用して、事前調停または調停ケースの更新または対応を行います。
	プレコンプライアンス/コンプライアンスケースの更新:拡張済み	このエンドポイントを使用して、事前コンプライアンスまたはコンプライアンスケースの更新または応答を行います。
Mastercom Extended - チャージバック管理	チャージバック取り消しの作成:拡張済み	このエンドポイントを使用して、既存のチャージバックを取り消します。
Mastercom Extended - 請求管理	要求を作成:拡張済み	このエンドポイントを使用して、新しい要求を作成します。
Mastercom Extended - 請求管理	事前コンプライアンス/コンプライアンスケースの作成:拡張	このエンドポイントを使用して、事前コンプライアンスまたはコンプライアンスケースを作成します。
Mastercom Extended - 異議申し立て管理	請求 ID で異議申し立てを開始:拡張	このエンドポイントを使用して、異議申し立てを開始します。現時点では、チャージバックの作成のみがサポートされています。
Mastercom Extended - ドキュメント管理	請求 ID とイベント ID でドキュメントを添付:拡張	このエンドポイントを使用して、以前にアップロードしたドキュメントを既存の異議申し立てイベントに添付します。
	ドキュメントの詳細を確認:拡張済み	このエンドポイントを使用して、ステータスなど、イベントに添付されたドキュメントの詳細を取得します。
	ドキュメントのアップロード:拡張	このエンドポイントを使用して、ドキュメントをアップロードします。ファイル制限の詳細については、「Mastercom 拡張 API 仕様」の「チュートリアルとガイド」セクションを参照してください。
Mastercom Extended - キュー管理	ID ストリームでキュー内の請求を検索:拡張	このエンドポイントを使用して、指定された日付範囲内のキュー内の請求のリストを取得します。
	ID でキューを検索:拡張	このエンドポイントを使用して、特定のキュー内のフィールドを取得します。
	キューストリームの検索:拡張	このエンドポイントを使用して、キューとそのフィールドのリストを取得します。
Mastercom Extended - レポート定義管理	レポートフィールドの検索:拡張	このエンドポイントを使用して、特定のレポート内のフィールドを取得します。
Mastercom Extended - レポート定義管理	レポートフィールドストリームを検索:拡張	このエンドポイントを使用して、レポートとそのフィールドのリストを取得します。
Mastercom Extended - レポート管理	レポートの作成 - 拡張	このエンドポイントを使用して、レポートの作成を要求します。注: レポートの生成には少なくとも 120 秒かかります。
	完了したレポートを検索:拡張	このエンドポイントを使用して、完了したレポートを取得します。
	レポートステータスを検索:拡張	このエンドポイントを使用して、特定のレポートのステータスを取得します。
	レポートストリームを検索:拡張	このエンドポイントを使用して、レポートステータスと reportCompletedId を取得します。
Mastercom Extended - リプレゼンメント・マネジメント	請求 ID とイベント ID で表示を更新:拡張	このエンドポイントを使用して表示を確認します。これにより、請求が作業済みキューに移動します。発行者は、認められた請求に対してさらなる措置を講じることができます。

接続および資格情報エイリアスの要件

統合ハブは、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。

スポークの設定については、「Mastercard スポークの設定」を参照してください。