How to Use Visa Global ATM Locator

Using the Find Nearby Totals Operation

This operation returns a simple list of ATM Names located within the specified radius of the request location (separated by "|"), and subtotals of the number of ATMs that match each of the filter criteria included in the request. For a detailed description of each ATM, you should use the "Find Nearby ATMs" operation instead.

E.g.:

“PLACENAMES”:“CHUCKS DONUTS|DONOVAN’S LIQUOR & DELI|PHOENIX RESTAURANT”, followed by totals for each filter criterion,

 “WHEELCHAIR”:”1”, “TOTALCOUNT”:“3”.

Up to 100 ATM locations around a 60 miles radius of the geo location provided may be returned, so it’s best to iterate the search criteria using the “Find Nearby Totals” operation first to narrow in on the right set, before getting all the details from the “Find Nearby ATMs” operation details later.  This operation enables you to perform tasks like refine search criteria iteratively, prepare a user interface, or reserve storage for the detailed list.

For complete details, please refer to the API Reference link.

To use the Find Nearby Totals operation, you need:

  • Location of the search center (Required), either as a comma separated string containing a single line address of {street, city, state, zip, country} (e.g. “101 Main St, Bigtown, OH, 10040, USA”), or as geo-coordinates (e.g. “Latitude": 37.394664,"Longitude": -122.062304)
  • Search radius, Required, e.g. “distance”:”10” and “distanceUnit”:”mi” (or “km”)
  • Search filter criteria, Optional, from the list below, e.g., "WHEELCHAIR" accessible:
PLACE_NAME Doing business as name.
CARD_ACCEPT ATM accepts both Visa and Plus, Plus Only or Visa Only. Most ATMs accept both Visa and Plus. (Y/N)
ACCEPTS_INTERNATIONAL_CARDS ATM accepts Visa/Plus cards issued from another country. (Y/N)
VPAY Highly secure, chip-only, PIN based debit product issued by European banks for use in shops to make purchases and at ATMs to withdraw cash. VPay is only available in the European Union. (Y/N)
PLUS_ALLIANCE_NO_SURCHARGE_FEE Allows customers of Financial Institutions that participate in Plus Alliance to use their ATM at no charge. Plus Alliance is a program that is only available in the U.S. (Y/N)
ACCEPTS_ATM_DEPOSITS

ATM will accept a deposit from another Financial Institution's customer. (B/C/E/N)

B = Accepts Checks and/or Cash Deposit

C = Accepts Cash Only Deposit

E = Accepts Envelope Only Deposit

N = No ATM Deposits Accepted

BALANCE_INQUIRY ATM has balance inquiry capability. (Y/N)
MINI_STATEMENT ATM has mini statement capability. (Y/N)
ATM_ACCOUNT_TRANSFER ATM allows account to account transfers. (Y/N)
CHIP_CAPABLE ATM is chip capable. (Y/N)
TAP ATM supports contactless functionality. (Y/N)
CARDLESS_ACCESS_CODE ATM supports cardless access code functionality. (Y/N)
PIN_CHANGE ATM supports PIN change functionality. (Y/N)
BRAILLE_AUDIO ATM has braille audio capability. (Y/N)
RETURN_FOREIGN_CURRENCY ATM has return foreign currency capability. (Y/N)
ATM_ACCESS_FEE_DOM_WDL ATM assesses surcharge fee on withdrawals from domestic issued cards. (Y/N)
ATM_ACCESS_FEE_INTL_WDL ATM assesses surcharge fee on withdrawals from international issued cards. (Y/N)
ATM_ACCESS_FEE_DEPOSITS ATM assesses surcharge fee on deposits. (Y/N)
ACCESS_FEE_RETURN_FORGN_CURNCY ATM assesses surcharge fee on return foreign currency. (Y/N)
RESTRICTED ATM is in a restricted area such as a secured area of a building, in an ATM room at a branch or at a club where membership is required. (Y/N)
DRIVE_UPS ATM is a drive-up location. (Y/N)
WHEELCHAIR ATM is wheelchair accessible. (Y/N)
OPER_HRS

Hours of operation. (A/B)

A = 24 Hours

B = Shopping/Building Hours

Using the Find Nearby ATMs Operation

This operation allows a project to retrieve complete details, such as the name, address, geo-coordinates and attributes (e.g., accessibility) for up to 100 ATMs near a given location. The list can be modified using the same search criteria discussed above in “Find Nearby ATM Totals”.

Using the Find Geocodes Operation

The “Find Geocodes” operation returns the geo-coordinates (latitude and longitude) that correspond to a specified street address.   A user might be interested in finding ATMs starting from a location other than his or her current location.

For example, a user is in New York preparing for a business trip and is looking up ATMs in San Francisco, starting from his or her hotel in San Francisco.  Geocode Inquiry would allow the project to request the geo-coordinates of the hotel in San Francisco, using the street address of the hotel as the starting point.

  • Specify the street address for inquiry as a comma separated single string of text of the form "street, city, state, zip, country" (e.g., "101 Main St., Bigtown, OH, 10040, USA").

Service Activation Requirements

As mentioned elsewhere, please note the Find Geocodes operation is provided strictly for use in conjunction with the ATM Locator functions, and not intended to be used outside of that context.  Use of the Find Geocodes operation outside of their intended application may void your license agreement.

Final deployment of the service is subject to Visa approval.