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 Find Geocodes operation 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 Global ATM Locator. To view availability of all products, refer to the Availability Matrix.

North America Asia-Pacific Europe CEMEA LAC Notes
    KEY
  • Available in entire region
  • Not available
  • See notes for available countries

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 2 million ATMs in over 200 countries.  The ATM Locator Service is a way to deliver user friendly 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, accessibility, etc.) from the list of available ATM search criteria discussed below.
  3. Using the “Find Nearby ATM Totals” 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 Find Nearby ATM Totals request as appropriate.
  5. Request the detailed list of ATMs with the “Find Nearby ATMs” operation, using the refined search criteria developed with Find Nearby ATM Totals.
  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 “Find Geocodes” operation to convert the local address(es) into a latitude and longitude.  Then use your preferred routing operation to provide walking or driving directions.
Description of Global ATM Locator APIs.

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).