Find Near by ATMs v3 returns error

[xinhuang_anz]

Hi Team,

The response for https://developer.visa.com/capabilities/atmlocator/reference#tag/Locate-ATMs-API_/paths/~1globalatml... is always

{ "responseStatus": { "statusCode": "API007", "statusDescription": "Forbidden - Client is not subscribed to web service" } }

but same request working for me with v1 version, https://sandbox.api.visa.com/globalatmlocator/v1/localatms/atmsinquiry, reckon it's not my account issue as error returns only with v3 version.

Could you please help investigate? Thanks.

[DianaVisaPM]

Hi @xinhuang_anz,

To investigate, please provide the following information:

1. End Point
2. Request Header
3. Request Body
4. Response Header (include the x-correlation-id)
5. Response Body

You can find the x-correlation-id in the response header.

[DianaVisaPM]

Hi @xinhuang_anz,

Please provide the information that I've requested of you in my prior post. 

[xinhuang_anz]

Hi Team,

The payloads are from https://developer.visa.com/capabilities/atmlocator/reference#tag/Locate-ATMs-API/operation/searchATM...

v1:

curl -v -X POST 'https://sandbox.api.visa.com/globalatmlocator/v1/localatms/atmsinquiry' \
--cert ./cert.pem \
--key ./key_ecd38740-8544-4e80-a9b3-a29976c40e6d.pem \
--user LCWK1NCTS47N4YSJFIFN21_oQOI3ivCNkFODQzB4W5sIZaKkM:47VV9rvbUWBYA7QWNik28ZGEXD50IeVJ4 \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-correlation-id: test-x-id' \
--data-raw '{
"wsRequestHeaderV2": {
"requestTs": "2015-08-11T01:49:53.887Z",
"requestMessageId": "test1234567801",
"userBid": "10000108",
"correlationId": "909420141104053819418",
"applicationId": "VATMLOC",
"userId": "CDISIUserID"
},
"requestData": {
"distanceUnit": "mi",
"distance": "60",
"culture": "en-US",
"options": {
"findFilters": [
{
"filterValue": "",
"filterName": "PLACE_NAME"
}
],
"range": {
"count": 10,
"start": 0
},
"operationName": "and",
"sort": {
"primary": "distance",
"direction": "asc"
},
"useFirstAmbiguous": true
},
"location": {
"address": null,
"geocodes": {
"latitude": 38.28352,
"longitude": -75.4169
},
"placeName": ""
},
"metaDataOptions": 0
}
}' | jq .

>> {
"wsResponseHeader": null,
"wsResponseHeaderV2": {
"totalNumberOfRecords": null,
"responseTs": 1719274311492,
"requestMessageId": "test1234567801",
"correlationId": "909420141104053819418",
"responseMessageId": "51VATMLOC1018420240625001149052",
"numOfRowsReturned": 0
},
"wsStatus": {
"statusCode": "CDI082",
"statusDesc": "Visa ATM Locator Svc-Solr Execution Failure"
},
"responseData": null,
"responseSummaryData": null
}

V3:

curl -v -X POST 'https://sandbox.api.visa.com/globalatmlocator/v3/localatms/atmsinquiry' \
--cert ./cert.pem \
--key ./key_ecd38740-8544-4e80-a9b3-a29976c40e6d.pem \
--user LCWK1NCTS47N4YSJFIFN21_oQOI3ivCNkFODQzB4W5sIZaKkM:47VV9rvbUWBYA7QWNik28ZGEXD50IeVJ4 \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
"requestData": {
"culture": "en-US",
"options": {
"sort": {
"primary": "distance",
"direction": "asc"
},
"range": {
"count": 10,
"start": 0
},
"findFilters": [
{
"filterName": "string",
"filterVaule": "string"
}
],
"operationName": "or",
"useFirstAmbiguous": true
},
"distance": 20,
"location": {
"address": {},
"geocodes": {
"latitude": "30.26759000000004",
"longitude": "-97.74298999999996"
},
"placeName": "Austin"
},
"distanceUnit": "mi",
"metaDataOptions": 0
},
"wsRequestHeaderV2": {
"userId": "CDISIUserID",
"userBid": "10000108",
"requestTs": "2021-04-14T20:28:16.000Z",
"applicationId": "VATMLOC",
"correlationId": "909420141104053819420",
"requestMessageId": "rohuang-001"
}
}' | jq .

>>
{
"responseStatus": {
"statusCode": "API007",
"statusDescription": "Forbidden - Client is not subscribed to web service"
}
}

[DianaVisaPM]

Hey @xinhuang_anz,

I ran a test using the Visa Developer Center Playground testing tool and received a successful request/response payload. Please see below, test again and share your result with us.

End Point https://sandbox.api.visa.com/globalatmlocator/v1/localatms/atmsinquiry
Method POST
Request
{
"wsRequestHeaderV2": {
"requestTs": "2019-06-14T21:02:25.000Z",
"requestMessageId": "ICE01-001",
"userBid": "10000108",
"correlationId": "909420141104053819418",
"applicationId": "VATMLOC",
"userId": "CDISIUserID"
},
"requestData": {
"distanceUnit": "mi",
"distance": "20",
"culture": "en-US",
"options": {
"findFilters": [
{
"filterValue": "C",
"filterName": "OPER_HRS"
},
{
"filterValue": "",
"filterName": "AIRPORT_CD"
},
{
"filterValue": "N",
"filterName": "WHEELCHAIR"
},
{
"filterValue": "N",
"filterName": "BRAILLE_AUDIO"
},
{
"filterValue": "N",
"filterName": "BALANCE_INQUIRY"
},
{
"filterValue": "N",
"filterName": "CHIP_CAPABLE"
},
{
"filterValue": "N",
"filterName": "PIN_CHANGE"
},
{
"filterValue": "N",
"filterName": "RESTRICTED"
},
{
"filterValue": "N",
"filterName": "PLUS_ALLIANCE_NO_SURCHARGE_FEE"
},
{
"filterValue": "N",
"filterName": "ACCEPTS_PLUS_SHARED_DEPOSIT"
},
{
"filterValue": "N",
"filterName": "V_PAY_CAPABLE"
},
{
"filterValue": "N",
"filterName": "READY_LINK"
}
],
"range": {
"start": 10,
"count": 20
},
"operationName": "or",
"sort": {
"primary": "city",
"direction": "asc"
},
"useFirstAmbiguous": true
},
"location": {
"address": null,
"geocodes": null,
"placeName": "700 Arch St, Pittsburgh, PA 15212"
},
"metaDataOptions": 0
}
}
Response
{
"wsResponseHeaderV2": {
"totalNumberOfRecords": null,
"responseTs": 1719446420914,
"responseMessageId": "51VATMLOC9328620240627000020748",
"requestMessageId": "ICE01-001",
"correlationId": "909420141104053819418",
"numOfRowsReturned": 0
},
"wsStatus": {
"statusDesc": "Visa ATM Locator Svc-AbInitio Graph Execution Failure",
"statusCode": "CDI018"
},
"wsResponseHeader": null,
"responseSummaryData": null,
"responseData": null
}
Response Header
Status Code: 200
Server : nginx
Date : Thu, 27 Jun 2024 00:00:20 GMT
Content-Type : application/json
Content-Length : 401
Connection : keep-alive
X-SERVED-BY : -5b884d9f8p9
X-CORRELATION-ID : 1719446420_591_255003604_-5b884d9f8p9_VDP_WS
X-AGS-Request-ID : v3:8647:cte:55c028:7e09adfc9469288d01ef6b247e495508
X-AGS-Request-ID : v3:8647:cte:73c009:fd3d53b0c9d53e370aa18c3790d41b60
X-APP-STATUS : 200
Cache-Control : no-cache, no-store, must-revalidate
X-Frame-Options : SAMEORIGIN
X-XSS-Protection : 0
X-Content-Type-Options : nosniff
Strict-Transport-Security : max-age=31536000;includeSubdomains
Pragma : no-cache
Expires : -1
Content-Security-Policy-Report-Only : default-src 'self' https://*.v.me https://*.visa.com;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.visa.com https://*.v.me;img-src 'self' https://*.v.me https://*.visa.com https://*.unica.com https://ad.doubleclick.net;style-src 'self' 'unsafe-inline' https://*.visa.com;object-src https://*.v.me https://*.visa.com data:;report-uri /logging/logCSPReport;
X-Content-Security-Policy-Report-Only : default-src 'self' https://*.v.me https://*.visa.com;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.visa.com https://*.v.me;img-src 'self' https://*.v.me https://*.visa.com https://*.unica.com https://ad.doubleclick.net;style-src 'self' 'unsafe-inline' https://*.visa.com;object-src https://*.v.me https://*.visa.com data:;report-uri /logging/logCSPReport;
X-WebKit-CSP-Report-Only : default-src 'self' https://*.v.me https://*.visa.com;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.visa.com https://*.v.me;img-src 'self' https://*.v.me https://*.visa.com https://*.unica.com https://ad.doubleclick.net;style-src 'self' 'unsafe-inline' https://*.visa.com;object-src https://*.v.me https://*.visa.com data:;report-uri /logging/logCSPReport;
X-XSS-Protection : 1; mode=block
X-Content-Type-Options : nosniff
Strict-Transport-Security : max-age=31536000;includeSubdomains;always
X-Frame-Options : SAMEORIGIN
Content-Security-Policy : default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval'

[xinhuang_anz]

Hi Tee,

I have no issue with V1 endpoint, I can get correct response from V1.

Could you please test V3?

https://sandbox.api.visa.com/globalatmlocator/v3/localatms/atmsinquiry

[DianaVisaPM]

Hi @xinhuang_anz,

Please use the v1 endpoint and not v3.  

[xinhuang_anz]

Hi Tee,

We are using v3 endpoint in production, why can we only use v1 in sandbox?

[DianaVisaPM]

Hi @xinhuang_anz,

We only have v1 available for sandbox testing.

[xinhuang_anz]

Thanks for the update.

If v3 is not available, it's better to mention it in the documentation. https://developer.visa.com/capabilities/atmlocator/reference#tag/Locate-ATMs-API_/paths/~1globalatml...