Mastercard Match
Mastercard MATCH is a merchant screening service that helps acquirers identify merchants associated with previous risk, fraud, or account termination events.
- Base URL:
https://api.mastercard.com - Auth:
bearer(pass your key via theapiKeyinput)
Operations
get_fraud_merchant_v3_termination_inquiry_irn— GET /fraud/merchant/v3/termination-inquiry/{IRN} — Returns information about Merchants, URLs and up to five principal owners, that have been terminated by an acquiring bank from a previous inquiry. The Inquiry History Results resource displays the inquiry with the option to view either; Possible Merchant Matches or Possible Inquiry Matches.post_fraud_merchant_v3_add_merchant— POST /fraud/merchant/v3/add-merchant — Used by Acquirers to add a terminated a merchant in the MATCH system. Merchant information, and up to five principal owners per merchant, can be provided by an acquiring bank as part of the listing.post_fraud_merchant_v3_common_contact_details— POST /fraud/merchant/v3/common/contact-details — Returns the contact information for the acquirer id requested. When MATCH returns a possible merchant match, this resource assists users by retrieving the contact information associated with the Acquirer ID/ICA that added the merchant to MATCH.post_fraud_merchant_v3_retro_retro_inquiry_detai— POST /fraud/merchant/v3/retro/retro-inquiry-details — Returns detailed information about Merchants, URLs and up to five principal owners, that have been terminated by an acquiring bank after the inquiry was made. This MATCH resource assists acquirer's ability to consider the merchants terminated after the inquiry was made. If an initial inquiry does not result in a possible match, it is still possible that the merchant listing could appear sometime in the next 360 days. This may occur when another acquirer enters the merchant into the MATCH database. The system will automatically continue to search the MATCH system for 360 days. To view these notifications, acquirers must use the Retroactive Inquiry Summary service. This resource can be used to obtain detailed information, such as, if a Merchant or individual has been terminated by another acquirer after an inquiry was made, the reason for termination, and the history of fraudulent or risky business practices that led to that termination.post_fraud_merchant_v3_retro_retro_list— POST /fraud/merchant/v3/retro/retro-list — Returns the summary of Retro matches for the given Acquirer Id. This resource will return the summary of Retroactive Inquiry matches for the given Acquirer ID/ICA. If an initial inquiry does not result in a possible match, it is still possible that the merchant listing could appear sometime in the next 360 days. This may occur when another acquirer enters the merchant into the MATCH database. The system will automatically continue to search the MATCH system for 360 days. To view these notifications, acquirers must use the Retroactive Inquiry service.post_fraud_merchant_v3_termination_inquiry— POST /fraud/merchant/v3/termination-inquiry — Returns information on merchants that have been terminated and merchants that have inquired upon. Provides the acquiring bank with information, such as, if a Merchant or individual has been terminated by another acquirer already, the reason for termination, the history of fraudulent or risky business practices that led to that termination and the inquiry that was made already on the Merchant or individual by own or another acquiring bank (if opted).
Inputs
apiKey— your mastercard-match API keyoperation— one of the operations above- path parameters when an operation's path contains
{...} query— optional JSON object of query paramsbody— JSON object for create/update ops
Example
operation: get_fraud_merchant_v3_termination_inquiry_irn
apiKey: <your key>
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
erroroperationresultstatus
Input Properties
Every property this tool accepts, from its own tool.iml.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
apiKey |
string | yes | — | DEPRECATED — bind an API Key credential to the task with credentialName instead. A key pasted here is stored in the workflow definition in clear and appears in every export of it. Still honoured for workflows built before the change. |
operation |
string | yes | — | One of: get_fraud_merchant_v3_termination_inquiry_irn, post_fraud_merchant_v3_add_merchant, post_fraud_merchant_v3_common_contact_details, post_fraud_merchant_v3_retro_retro_inquiry_detai, post_fraud_merchant_v3_retro_retro_list, post_fraud_merchant_v3_termination_inquiry |
IRN |
string | no | — | Path parameter IRN (required by some operations). |
query |
string | no | — | Optional query params as a JSON object string, e.g. {"limit": 10}. |
body |
string | no | — | Request body as a JSON object string (for create/update operations). |