# Visa Supplier Matching Service

Search API Reference

- [Getting Started](https://developer.visa.com/capabilities/suppliermatchingservice/docs-getting-started)
- [Authentication Method](https://developer.visa.com/capabilities/suppliermatchingservice/docs-authentication)
- [How to Use Visa Supplier Matching Service](https://developer.visa.com/capabilities/suppliermatchingservice/docs-how-to)
- [Error Codes](https://developer.visa.com/pages/visa-developer-error-codes)
- [Product Terms](https://developer.visa.com/capabilities/suppliermatchingservice/product-terms)
- [Request & Response Codes](https://developer.visa.com/request_response_codes)

# Visa Supplier Matching Service API

Visa Supplier Matching Service

## Match suppliers to Visa merchants  v1 - Latest

Match suppliers to Visa merchants

### Request

##### query Parameters

|     |     |
| --- | --- |
| supplierCity | string<br>City of the Supplier |
| supplierCountryCode<br>required | string<br>Country Code of the Supplier<br>Refer to [ISO Country Codes](https://developer.visa.com/request_response_codes#iso_country_and_currency_codes) |
| supplierName<br>required | string<br>Name of the Supplier |
| supplierPhoneNumber | string<br>Phone number of the Supplier |
| supplierPostalCode | string<br>Postal Code of the Supplier |
| supplierState | string<br>State of the Supplier |
| supplierStreetAddress | string<br>Address of Supplier |
| supplierTaxId | string<br>Tax Id of the Supplier |

### Responses

201
Created

##### Response Schema: application/json

|     |     |
| --- | --- |
| matchConfidence | string |
| matchDetails | object |
| |     |     |
| --- | --- |
| fleetInd | string |
| l2 | string |
| l3li | string |
| l3s | string |
| mcc | string | |
| matchStatus | string |
| status | object |
| |     |     |
| --- | --- |
| statusCode | string |
| statusDescription | string |

#### Error Codes

| Status | Code | Description |
| --- | --- | --- |
| 401 |  | Unauthorized |
| 404 |  | Not Found |
| 200 | SMSAPI000 | Request successfully received |
| 200 | SMSAPI111 | Service Unavailable |
| 200 | SMSAPI011 | Request Data Supplier name value is null/empty |
| 200 | SMSAPI012 | Request Data Name Length exceeded max character length |
| 200 | SMSAPI013 | Request Data Address Length exceeded max character length |
| 200 | SMSAPI014 | Request Data City Length exceeded max character length |
| 200 | SMSAPI015 | Request Data State Length exceeded max character length |
| 200 | SMSAPI016 | Request Data Postal Length exceeded max character length |
| 200 | SMSAPI017 | Request Data Country code value is null/empty |
| 200 | SMSAPI018 | Request Data Country Length exceeded max character length |
| 200 | SMSAPI019 | Request Data country not supported |
| 403 |  | Forbidden |

post/visasuppliermatchingservice/v1/search

Sandbox server

https://sandbox.api.visa.com/visasuppliermatchingservice/v1/search

Copy

Response samples

- 201

application/json

Copy

Expand allCollapse all

`{"matchConfidence": "High",

"matchStatus": "Yes",

"matchDetails": {"l3li": "",

"l2": "",

"fleetInd": "",

"mcc": "3501",

"l3s": ""

},

"status": {"statusDescription": "Request successfully received",

"statusCode": "SMSAPI000"

}
}`