Getting Started with Visa Global ATM Locator

Things to Know

The Global ATM Locator API can be used by any developer in the sandbox. To use the API in production, you must either be a Visa issuer or be pre-approved by Visa to use the service. The Global ATM Locator API Licensing Agreement and approval process is available as part of Production Onboarding.

The Geocode Inquiry and Routes Inquiry operations are provided by a third-party and may only be used in conjunction with the Global ATM Locator API. Any other use of these operations could violate the Terms of Use for the service.

Availability

The following table lists the regional availability for Visa Transaction Controls. To view availability of all products, refer to the Availability Matrix.

Available in entire region

Limited availability in region

Not available

Region Availability Notes
North America
Asia-Pacific
Europe
CEMEA
LAC

About Global ATM Locator

Visa Global ATM Locator enables cardholders to search for Visa/Plus ATM locations around the world, via the Web or from their internet-enabled mobile devices.

The Visa Global ATM Locator service lets cardholders find a convenient ATM when they need cash from over 1 million ATMs in over 200 countries.  The ATM Locator Service is a cost effective way to deliver user friendly, trusted information when users need cash while travelling or in emergencies. To use the Global ATM Locator service, follow these steps:

  1. Get the location where the user wants to center the search radius.  A street address works, or you can use the geo-location of the user’s mobile phone.
  2. Select any search criteria for the ATM (e.g. hours of operation, wheelchair accessibility, etc.) from the list of available ATM search criteria discussed below.
  3. Using the “Totals Inquiry” operation, check the number of ATMs that meet the user’s search criteria, before requesting the complete list of ATM details (which could be large).   Totals can be useful to refine search criteria, format displays, or pre-allocate memory resources.
  4. Based on the totals returned, help the user refine the search criteria if needed, iterating the Totals Inquiry request as appropriate.
  5. Request the detailed list of ATMs with the “ATMs Inquiry” operation, using the refined search criteria developed with Totals Inquiry.
  6. Display the list and let the user select the best fit from among the ATMs in the list.
  7. Finally, provide the user with the route from the current (or alternate) location to the ATM selected from the list by using the “Geocode Inquiry” to convert the local address(es) into a latitude and longitude.  Then use, the “Routes Inquiry” operation to provide walking or driving directions.
Process flow for Global ATM Locator

APIs Included

Locate ATMs

The Locate ATMs API provides the means to find up to 100 ATM locations that match a set of filter criteria and are near a given location (near a given single-line input address/geocode). The Locate ATMs API can also find routing information for a given start and destination point.