searchOptions.confidenceScores result to CDI071 Bad Request

[KrisC]

Hi!

I'm testing Visa merchant search and I've been getting responses. I'm trying out the searchOption "confidenceScores" and setting it to true to observe what the response would look like especially for a response that contains more than one merchant in the result. This is my request:

{
  "header": {
    "startIndex": "0",
    "requestMessageId": "test_{{$guid}}",
    "messageDateTime": "{{now}}"
  },
  "responseAttrList": [
    "GNSTANDARD"
  ],
  "searchAttrList": {
      "merchantName": "mcdonalds",
      "merchantCountryCode": "840",
      "merchantPostalCode": "33172"
  },
  "searchOptions": {
      "confidenceScores": true
  }
}

And this is the response I get:

{
    "merchantSearchServiceResponse": {
        "header": {
            "startIndex": "0",
            "messageDateTime": "2023-10-06T21:42:03.003",
            "requestMessageId": "test_d812844b-cae4-4264-9fc6-54ab26be4a6a",
            "responseMessageId": "f90a7da5-491e-4a89-a789-4d54a361334c",
            "numRecordsMatched": 0,
            "numRecordsReturned": 0
        },
        "status": {
            "statusCode": "CDI071",
            "statusDescription": "Bad Request - #/searchOptions/confidenceScores"
        }
    }
}

Without the "confidenceScores", this is the response:

{
    "merchantSearchServiceResponse": {
        "header": {
            "startIndex": "0",
            "endIndex": "4",
            "messageDateTime": "2023-10-06T21:49:53.053",
            "requestMessageId": "test_67445566-19bb-483b-8383-3ea9431aae46",
            "responseMessageId": "90a751ba-3b07-4017-8616-6dfbd5df8cbc",
            "numRecordsMatched": 5,
            "numRecordsReturned": 5
        },
        "response": [
            {
                "responseValues": {
                    "visaEnterpriseName": "MCDONALDS",
                    "merchantPhoneNumber": [
                        {
                            "type": "O",
                            "number": "3056707600"
                        }
                    ],
                    "soleProprietorIndicator": "N",
                    "lastTranDateRange": "IN LAST 90 DAYS",
                    "merchantCity": "MIAMI",
                    "merchantCountryCode": "840",
                    "smallBusinessIndicator": "N",
                    "visaEnterpriseId": "330549737",
                    "locationAddressLongitude": "-80.355583",
                    "paymentAcceptanceMethod": [
                        "F2F",
                        "MOTO"
                    ],
                    "merchantCategoryCodeDesc": [
                        "FAST FOOD RESTAURANTS"
                    ],
                    "firstTranDateRange": "IN MORE THAN 365 DAYS",
                    "merchantState": "FL",
                    "terminalType": [
                        "SWIPE",
                        "PAYWAVE"
                    ],
                    "visaMerchantId": "23931308",
                    "visaStoreName": "MCDONALDS",
                    "primaryMerchantCategoryCode": "5814",
                    "locationAddressLatitude": "25.7792",
                    "merchantCategoryCode": [
                        "5814"
                    ],
                    "merchantPostalCode": "33172",
                    "visaStoreId": "177459211",
                    "visaMerchantName": "MCDONALDS",
                    "merchantUrl": [
                        "MCDONALDS.COM"
                    ]
                }
            },
            {
                "responseValues": {
                    "visaEnterpriseName": "MCDONALDS",
                    "merchantPhoneNumber": [
                        {
                            "type": "O",
                            "number": "4102797771"
                        },
                        {
                            "type": "O",
                            "number": "3052350941"
                        }
                    ],
                    "merchantCountryCode": "840",
                    "visaEnterpriseId": "330549737",
                    "locationAddressLongitude": "-80.329998",
                    "paymentAcceptanceMethod": [
                        "F2F",
                        "EC",
                        "MOTO"
                    ],
                    "merchantCategoryCodeDesc": [
                        "FAST FOOD RESTAURANTS"
                    ],
                    "firstTranDateRange": "IN MORE THAN 365 DAYS",
                    "merchantState": "FL",
                    "visaStoreName": "MCDONALDS",
                    "locationAddressLatitude": "25.652747",
                    "merchantPostalCode": "33156-5931",
                    "visaStoreId": "134470528",
                    "dbaname": [
                        "MCDONALD'S M6280 OF FL"
                    ],
                    "visaMerchantName": "MCDONALDS",
                    "soleProprietorIndicator": "N",
                    "lastTranDateRange": "IN LAST 90 DAYS",
                    "merchantCity": "MIAMI",
                    "smallBusinessIndicator": "N",
                    "terminalType": [
                        "SWIPE",
                        "CHIP",
                        "PAYWAVE"
                    ],
                    "visaMerchantId": "23931308",
                    "primaryMerchantCategoryCode": "5814",
                    "merchantCategoryCode": [
                        "5814"
                    ],
                    "businessLegalName": [
                        "MCDONALDS"
                    ],
                    "merchantStreetAddress": "12647 S DIXIE HWY",
                    "merchantUrl": [
                        "WWW.MCDONALDS.COM"
                    ]
                }
            },
            {
                "responseValues": {
                    "visaEnterpriseName": "MCDONALDS",
                    "merchantPhoneNumber": [
                        {
                            "type": "O",
                            "number": "3052284343"
                        },
                        {
                            "type": "O",
                            "number": "3056610024"
                        }
                    ],
                    "merchantCountryCode": "840",
                    "visaEnterpriseId": "330549737",
                    "locationAddressLongitude": "-80.432291",
                    "paymentAcceptanceMethod": [
                        "F2F",
                        "MOTO"
                    ],
                    "merchantCategoryCodeDesc": [
                        "FAST FOOD RESTAURANTS"
                    ],
                    "firstTranDateRange": "IN MORE THAN 365 DAYS",
                    "merchantState": "FL",
                    "visaStoreName": "MCDONALDS",
                    "locationAddressLatitude": "25.760886",
                    "merchantPostalCode": "33184-3135",
                    "visaStoreId": "137625872",
                    "dbaname": [
                        "MCDONALD'S F31617"
                    ],
                    "visaMerchantName": "MCDONALDS",
                    "soleProprietorIndicator": "Y",
                    "lastTranDateRange": "IN LAST 90 DAYS",
                    "merchantCity": "MIAMI",
                    "smallBusinessIndicator": "Y",
                    "terminalType": [
                        "SWIPE",
                        "PAYWAVE"
                    ],
                    "visaMerchantId": "23931308",
                    "primaryMerchantCategoryCode": "5814",
                    "merchantCategoryCode": [
                        "5814"
                    ],
                    "businessLegalName": [
                        "ARGO MANAGEMENT"
                    ],
                    "merchantStreetAddress": "14670 SW 8TH ST",
                    "merchantUrl": [
                        "WWW.MCDONALDS.COM",
                        "MCDONALDS.COM"
                    ]
                }
            },
            {
                "responseValues": {
                    "visaEnterpriseName": "MCDONALDS",
                    "merchantPhoneNumber": [
                        {
                            "type": "O",
                            "number": "3059687266"
                        }
                    ],
                    "merchantCountryCode": "840",
                    "visaEnterpriseId": "330549737",
                    "locationAddressLongitude": "-80.248105",
                    "paymentAcceptanceMethod": [
                        "F2F",
                        "MOTO"
                    ],
                    "merchantCategoryCodeDesc": [
                        "FAST FOOD RESTAURANTS"
                    ],
                    "firstTranDateRange": "IN MORE THAN 365 DAYS",
                    "merchantState": "FL",
                    "visaStoreName": "MCDONALD'S",
                    "locationAddressLatitude": "25.749996",
                    "merchantPostalCode": "33145-2234",
                    "visaStoreId": "143326799",
                    "dbaname": [
                        "MCDONALD'S F1789"
                    ],
                    "visaMerchantName": "MCDONALDS",
                    "soleProprietorIndicator": "N",
                    "lastTranDateRange": "IN LAST 90 DAYS",
                    "merchantCity": "MIAMI",
                    "smallBusinessIndicator": "N",
                    "terminalType": [
                        "SWIPE",
                        "PAYWAVE"
                    ],
                    "visaMerchantId": "23931308",
                    "primaryMerchantCategoryCode": "5814",
                    "merchantCategoryCode": [
                        "5814"
                    ],
                    "businessLegalName": [
                        "AMPY ENTERPRISES INC."
                    ],
                    "merchantStreetAddress": "3280 CORAL WAY",
                    "merchantUrl": [
                        "MCDONALDS.COM"
                    ]
                }
            },
            {
                "responseValues": {
                    "visaEnterpriseName": "MCDONALDS",
                    "merchantPhoneNumber": [
                        {
                            "type": "O",
                            "number": "3055930376"
                        },
                        {
                            "type": "O",
                            "number": "3056707600"
                        }
                    ],
                    "merchantCountryCode": "840",
                    "visaEnterpriseId": "330549737",
                    "locationAddressLongitude": "-80.317338",
                    "paymentAcceptanceMethod": [
                        "F2F",
                        "MOTO"
                    ],
                    "merchantCategoryCodeDesc": [
                        "FAST FOOD RESTAURANTS"
                    ],
                    "firstTranDateRange": "IN MORE THAN 365 DAYS",
                    "merchantState": "FL",
                    "visaStoreName": "MCDONALDS",
                    "locationAddressLatitude": "25.809401",
                    "merchantPostalCode": "33166-6706",
                    "visaStoreId": "177132678",
                    "dbaname": [
                        "MCDONALD'S F6486"
                    ],
                    "visaMerchantName": "MCDONALDS",
                    "soleProprietorIndicator": "N",
                    "lastTranDateRange": "IN LAST 90 DAYS",
                    "merchantCity": "MIAMI",
                    "smallBusinessIndicator": "N",
                    "terminalType": [
                        "SWIPE"
                    ],
                    "visaMerchantId": "23931308",
                    "primaryMerchantCategoryCode": "5814",
                    "merchantCategoryCode": [
                        "5814"
                    ],
                    "businessLegalName": [
                        "MEGA FOODS, INC"
                    ],
                    "merchantStreetAddress": "7405 NW 36TH ST",
                    "merchantUrl": [
                        "WWW.MCDONALDS.COM",
                        "MCDONALDS.COM"
                    ]
                }
            }
        ],
        "status": {
            "statusCode": "CDI000",
            "statusDescription": "Success"
        }
    }
}

Could someone please help me understand why I'm getting an error when using the "confidenceScores" search option.

[jenn_kh]

Thank you for reaching out, @KrisC! An agent will look into this and get back to you as soon as possible. Until then, if any community member knows a solution, please reply to this thread. 

[KrisC]

Hi @jenn_kh,

Any updates on this please?

Thanks,

Kris

[API_Products]

Hi @KrisC,

To investigate the error, please provide the information below.

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.

[KrisC]

Hi @API_Products,

Please see below in-line responses.

1. End Point: https://sandbox.api.visa.com/merchantsearch/v2/search
2. Request Header

Content-Type: application/json
Authorization: Basic MTBNUjlaNkVNOThaSzQxTzc0VlYyMWsxVTM1M1hKWWNucFpueHdhSjEySWt6SWliTTowMVEwanlJc1BnM0xqVnhqOWpSMlljUEJrNw==
User-Agent: PostmanRuntime/7.33.0
Accept: */*
Cache-Control: no-cache
Postman-Token: 7dc6fd71-45d7-40e6-9b78-cfe05e9615b2
Host: sandbox.api.visa.com
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 399

3. Request Body

{
  "header": {
    "startIndex": "0",
    "requestMessageId": "test_526c5f07-1f59-427f-ae08-852d1b65edcb",
    "messageDateTime": "2023-10-19T11:53:50.956"
  },
  "responseAttrList": [
    "GNSTANDARD"
  ],
  "searchAttrList": {
      "merchantName": "mcdonalds",
      "merchantCountryCode": "840",
      "merchantPostalCode": "33172"
  },
  "searchOptions": {
      "confidenceScores": true
  }
}

4. Response Header (include the x-correlation-id)

Server: nginx
Date: Thu, 19 Oct 2023 11:53:51 GMT
Content-Type: application/json
Content-Length: 376
Connection: keep-alive
X-SERVED-BY: b9f55w85
X-CORRELATION-ID: 1697716431_291_434552247_b9f55w85_VDP_WS
response-message-id: 6f525db1-4bfd-47b0-9e04-76f4afcf3b05
response-message-ts: 2023-10-19T11:53:51.631413681Z
X-AGS-Request-ID: v3:8653:sandbox:73c010:c5db7154773271e64e9e4f31d4cbc05b
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

5. Response Body

{"merchantSearchServiceResponse":{"header":{"startIndex":"0","messageDateTime":"2023-10-19T11:53:51.051","requestMessageId":"test_526c5f07-1f59-427f-ae08-852d1b65edcb","responseMessageId":"6f525db1-4bfd-47b0-9e04-76f4afcf3b05","numRecordsMatched":0,"numRecordsReturned":0},"status":{"statusCode":"CDI071","statusDescription":"Bad Request - #/searchOptions/confidenceScores"}}}

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

[API_Products]

Hi @KrisC,

I got a successful Merchant Search request/response payload today. I've provided the successful request/response payload below. I've include the links to the guides for sandbox testing below. You're free to use whatever tool you'd like. Please test again and share your result with us.

Visa Developer Center Playground

Developer Quick Start Guide

End Point https://sandbox.api.visa.com/merchantsearch/v2/search
Method POST
Request
{
"searchOptions": {
"matchScore": "true",
"maxRecords": "10",
"matchIndicators": "true",
"proximity": ["merchantName"],
"wildCard": ["merchantName"]
},
"header": {
"startIndex": "0",
"requestMessageId": "VCO_GMR_001",
"messageDateTime": "2015-08-28T22:05:00.000"
},
"searchAttrList": {
"merchantPhoneNumber": "4153440351",
"merchantCity": "San Francisco",
"merchantCountryCode": "840",
"merchantPostalCode": "94107",
"paymentAcceptanceMethod": "F2F",
"visaStoreId": "161688518",
"merchantStreetAddress": "280 King St",
"merchantState": "CA",
"merchantName": "starbucks ",
"terminalType": "SWIPE"
},
"responseAttrList": ["GNSTANDARD"]
}
Response
{"merchantSearchServiceResponse": {
"response": [
{
"matchScore": 74.691444,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "Y",
"visaStoreId": "Y",
"merchantStreetAddress": "Y",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [{
"number": "4153440351",
"type": "O"
}],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.393581",
"paymentAcceptanceMethod": ["F2F"],
"merchantCategoryCodeDesc": ["FAST FOOD RESTAURANTS"],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS",
"locationAddressLatitude": "37.776827",
"merchantPostalCode": "94107-1702",
"visaStoreId": "161688518",
"dbaname": ["Starbucks Store 06677"],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 90 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": ["5814"],
"businessLegalName": ["Starbucks Corporation"],
"merchantStreetAddress": "280 KING ST",
"merchantUrl": ["www.starbucks.com"]
}
},
{
"matchScore": 25.87994,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "N",
"visaStoreId": "N",
"merchantStreetAddress": "N",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.397518",
"paymentAcceptanceMethod": [
"F2F",
"EC"
],
"merchantCategoryCodeDesc": [
"FAST FOOD RESTAURANTS",
"MISC PERSONAL SERV - DEF"
],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS STORE",
"locationAddressLatitude": "37.789767",
"merchantPostalCode": "94105-2634",
"visaStoreId": "145089994",
"dbaname": ["Starbucks Store 17517"],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 90 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": [
"7299",
"5814"
],
"businessLegalName": ["Starbucks Corporation"],
"merchantStreetAddress": "100 1ST ST",
"merchantUrl": ["STARBUCKS.COM"]
}
},
{
"matchScore": 25.610157,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "N",
"visaStoreId": "N",
"merchantStreetAddress": "N",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.400974",
"paymentAcceptanceMethod": ["F2F"],
"merchantCategoryCodeDesc": ["FAST FOOD RESTAURANTS"],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS",
"locationAddressLatitude": "37.630415",
"merchantPostalCode": "94128-3103",
"visaStoreId": "170764616",
"dbaname": [
"STARBUCKS INTL30091532",
"STARBUCKS INT 30091540",
"STARBUCKS SFO 30091524"
],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 180 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": ["5814"],
"businessLegalName": ["HMS HOST CORPORATION"],
"merchantStreetAddress": "780 MCDONNELL RD",
"merchantUrl": ["STARBUCKS.COM"]
}
},
{
"matchScore": 25.29638,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "N",
"visaStoreId": "N",
"merchantStreetAddress": "N",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [{
"number": "4159898759",
"type": "O"
}],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.401254",
"paymentAcceptanceMethod": ["F2F"],
"merchantCategoryCodeDesc": ["FAST FOOD RESTAURANTS"],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS",
"locationAddressLatitude": "37.793558",
"merchantPostalCode": "94104-1341",
"visaStoreId": "219576183",
"dbaname": ["Starbucks Store 00533"],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 90 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": ["5814"],
"businessLegalName": ["Starbucks Corporation"],
"merchantStreetAddress": "343 SANSOME ST STE 190",
"merchantUrl": ["www.starbucks.com"]
}
},
{
"matchScore": 25.29638,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "N",
"visaStoreId": "N",
"merchantStreetAddress": "N",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.463756",
"paymentAcceptanceMethod": ["F2F"],
"merchantCategoryCodeDesc": ["FAST FOOD RESTAURANTS"],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS STORE",
"locationAddressLatitude": "37.733599",
"merchantPostalCode": "94127",
"visaStoreId": "209029977",
"dbaname": ["Starbucks Store 05669"],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 90 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": ["5814"],
"businessLegalName": ["Starbucks Corporation"],
"merchantStreetAddress": "3338 N TEXAS ST STE A",
"merchantUrl": ["STARBUCKS.COM"]
}
},
{
"matchScore": 25.29638,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "N",
"visaStoreId": "N",
"merchantStreetAddress": "N",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [{
"number": "4159799530",
"type": "O"
}],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.403432",
"paymentAcceptanceMethod": ["F2F"],
"merchantCategoryCodeDesc": ["FAST FOOD RESTAURANTS"],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS",
"locationAddressLatitude": "37.787423",
"merchantPostalCode": "94103-3214",
"visaStoreId": "208801408",
"dbaname": ["Starbucks Store 10347"],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 90 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": ["5814"],
"businessLegalName": ["Starbucks Corporation"],
"merchantStreetAddress": "7 3RD ST",
"merchantUrl": [
"STARBUCKS.COM",
"www.starbucks.com"
]
}
},
{
"matchScore": 25.29638,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "N",
"visaStoreId": "N",
"merchantStreetAddress": "N",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.389444",
"paymentAcceptanceMethod": ["F2F"],
"merchantCategoryCodeDesc": ["FAST FOOD RESTAURANTS"],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS STORE",
"locationAddressLatitude": "37.771328",
"merchantPostalCode": "94158-2210",
"visaStoreId": "208536547",
"dbaname": ["Starbucks Store 25428"],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 90 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": ["5814"],
"businessLegalName": ["Starbucks Corporation"],
"merchantStreetAddress": "1449 3RD ST"
}
},
{
"matchScore": 25.29638,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "N",
"visaStoreId": "N",
"merchantStreetAddress": "N",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [{
"number": "4156266263",
"type": "O"
}],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.434905",
"paymentAcceptanceMethod": ["F2F"],
"merchantCategoryCodeDesc": ["FAST FOOD RESTAURANTS"],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS",
"locationAddressLatitude": "37.760875",
"merchantPostalCode": "94114-2534",
"visaStoreId": "189709695",
"dbaname": ["Starbucks Store 09212"],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 90 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": ["5814"],
"businessLegalName": ["Starbucks Corporation"],
"merchantStreetAddress": "4094 18TH ST",
"merchantUrl": ["www.starbucks.com"]
}
},
{
"matchScore": 25.29638,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "N",
"visaStoreId": "N",
"merchantStreetAddress": "N",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [{
"number": "4153988630",
"type": "O"
}],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.397182",
"paymentAcceptanceMethod": ["F2F"],
"merchantCategoryCodeDesc": ["FAST FOOD RESTAURANTS"],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS",
"locationAddressLatitude": "37.793597",
"merchantPostalCode": "94111-4603",
"visaStoreId": "189660504",
"dbaname": ["Starbucks Store 09222"],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 90 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": ["5814"],
"businessLegalName": ["Starbucks Corporation"],
"merchantStreetAddress": "52 CALIFORNIA ST",
"merchantUrl": ["www.starbucks.com"]
}
},
{
"matchScore": 25.29638,
"matchIndicators": {
"merchantPhoneNumber": "N",
"merchantCountryCode": "Y",
"merchantCity": "Y",
"merchantPostalCode": "N",
"visaStoreId": "N",
"merchantStreetAddress": "N",
"merchantState": "Y",
"merchantName": "Y"
},
"responseValues": {
"visaEnterpriseName": "STARBUCKS CORPORATION",
"merchantPhoneNumber": [{
"number": "4152527423",
"type": "O"
}],
"merchantCountryCode": "840",
"visaEnterpriseId": "336582810",
"locationAddressLongitude": "-122.393729",
"paymentAcceptanceMethod": ["F2F"],
"merchantCategoryCodeDesc": ["FAST FOOD RESTAURANTS"],
"firstTranDateRange": "IN MORE THAN 365 DAYS",
"merchantState": "CA",
"visaStoreName": "STARBUCKS",
"locationAddressLatitude": "37.767592",
"merchantPostalCode": "94158-0005",
"visaStoreId": "177165464",
"dbaname": ["Starbucks Store 14311"],
"visaMerchantName": "STARBUCKS",
"soleProprietorIndicator": "N",
"lastTranDateRange": "IN LAST 90 DAYS",
"merchantCity": "SAN FRANCISCO",
"smallBusinessIndicator": "N",
"terminalType": [
"SWIPE",
"CHIP",
"PAYWAVE"
],
"visaMerchantId": "29992901",
"primaryMerchantCategoryCode": "5814",
"merchantCategoryCode": ["5814"],
"businessLegalName": ["Starbucks Corporation"],
"merchantStreetAddress": "1700 OWENS ST STE 120",
"merchantUrl": ["www.starbucks.com"]
}
}
],
"header": {
"numRecordsReturned": 10,
"startIndex": "0",
"numRecordsMatched": 59,
"responseMessageId": "fd465148-e31c-4c8f-9095-9b38964161e0",
"endIndex": "9",
"requestMessageId": "VCO_GMR_001",
"messageDateTime": "2023-10-24T17:38:12.012"
},
"status": {
"statusDescription": "Success",
"statusCode": "CDI000"
}
}}
Response Header
Status Code: 200
Server : nginx
Date : Tue, 24 Oct 2023 17:38:12 GMT
Content-Type : application/json
Content-Length : 12122
Connection : keep-alive
X-SERVED-BY : b9f55d
X-CORRELATION-ID : 1698169092_017_1294315564_b9f55d_VDP_WS
response-message-id : fd465148-e31c-4c8f-9095-9b38964161e0
response-message-ts : 2023-10-24T17:38:12.500163282Z
X-AGS-Request-ID : v3:8653:sandbox:73c009:21cd2e681f83b9fbdcfc9bf8279e745b
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

[KrisC]

Hi Diana,

Thanks for your response and the example.

I see that you used matchScore. I'm particularly interested in the confidenceScores since according to the API docs, https://developer.visa.com/capabilities/merchant_search/reference#tag/Generic-Search/operation/gener..., "...Use confidence score to evaluate quality of response."

Would you be able to share with me a sample request that uses confidenceScores in the searchOptions?

Thanks,

Kris

[KrisC]

Apologies for the big texts. Those were supposed to be bold text to highlight the text since I can't find a way to make it appear like pre-formatted/code text.

[API_Products]

Hi @KrisC,

I'll check with the product team and get back soon. 

[API_Products]

Hi @KrisC,

Just want to give you a quick update that the engineering team is checking the logs for the error and we'll get back soon.