Mastercard Locations
Mastercard Locations is an API for finding Mastercard-related locations such as ATMs, merchants, or acceptance points.
- Base URL:
https://api.mastercard.com - Auth:
bearer(pass your key via theapiKeyinput)
Operations
get_atms_v1_atm— GET /atms/v1/atm — Returns detailed information about an ATM location. This information can be used to display ATMs on a map, provide driving directions, or show special ATM features.get_atms_v1_country— GET /atms/v1/country — Returns countries with valid ATM locations.get_atms_v1_countrysubdivision— GET /atms/v1/countrysubdivision — Returns country subdivisions that have ATM locations. A country subdivision is a segment within a country (ex state or province). Country subdivisions are only available for the US and Canada.-
get_merchants_v1_category— GET /merchants/v1/category — Returns a list of all merchant categories for contactless and cash back merchants (example: Airline, Retail, etc.). -
get_merchants_v1_country— GET /merchants/v1/country — Returns countries that have Merchants offering the following services: accept contactless-enabled cards and devices, allow customers to add money to an eligible MasterCard or Maestro prepaid card, issue MasterCard Prepaid Travel cards, offer cash at checkout when paying with a Debit MasterCard or Maestro Card. -
get_merchants_v1_countrysubdivision— GET /merchants/v1/countrysubdivision — Returns country subdivisions that have Merchants offering the following services: accept contactless-enabled cards and devices, allow customers to add money to an eligible MasterCard or Maestro prepaid card, issue MasterCard Prepaid Travel cards, offer cash at checkout when paying with a Debit MasterCard or Maestro Card. A country subdivision is a segment within a country (ex state or province). Please note country subdivisions are only available for the US and Canada.
Inputs
apiKey— your mastercard-locations 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_atms_v1_atm
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_atms_v1_atm, get_atms_v1_country, get_atms_v1_countrysubdivision, get_merchants_v1_category, get_merchants_v1_country, get_merchants_v1_countrysubdivision |
query |
string | no | — | Optional query params as a JSON object string, e.g. {"limit": 10}. |