# Visa Supplier Matching Service
Drive spend to suppliers that accept Visa Commercial Payments.

## Version: 1

### Servers

| URL | Description |
| --- | ----------- |
| https://sandbox.api.visa.com | Sandbox server |

---
## Visa Supplier Matching Service API
Visa Supplier Matching Service

### [POST] /visasuppliermatchingservice/v1/search
**Match suppliers to Visa merchants**

#### Parameters

| Name | Located in | Description | Required | Schema | Style | Explode |
| ---- | ---------- | ----------- | -------- | ------ | ----- | ------- |
| supplierName | query | Name of the Supplier | Yes | string | form | Yes |
| supplierStreetAddress | query | Address of Supplier | No | string | form | Yes |
| supplierCity | query | City of the Supplier | No | string | form | Yes |
| supplierState | query | State of the Supplier | No | string | form | Yes |
| supplierPostalCode | query | Postal Code of the Supplier | No | string | form | Yes |
| supplierCountryCode | query | Country Code of the Supplier<br><br>Refer to <a href="/request_response_codes#iso_country_and_currency_codes">ISO Country Codes</a> | Yes | string | form | Yes |
| supplierPhoneNumber | query | Phone number of the Supplier | No | string | form | Yes |
| supplierTaxId | query | Tax Id of the Supplier | No | string | form | Yes |

#### Responses

| Code | Description | Schema |
| ---- | ----------- | ------ |
| 201 | Created | **application/json**: { **"status"**: { **"statusCode"**: string, **"statusDescription"**: string }, **"matchStatus"**: string, **"matchDetails"**: { **"l2"**: string, **"l3s"**: string, **"mcc"**: string, **"l3li"**: string, **"fleetInd"**: string }, **"matchConfidence"**: string }<br> |

---
## Visa Supplier Matching Service Bulk API
VISA Supplier Matching Service

### [GET] /visasuppliermatchingservice/v1/status
**Status**

Supplier Matching Service Bulk File Status

#### Parameters

| Name | Located in | Description | Required | Schema | Style | Explode |
| ---- | ---------- | ----------- | -------- | ------ | ----- | ------- |
| fileId | query | Otf Id of request file  | Yes | string | form | Yes |

#### Responses

| Code | Description | Schema |
| ---- | ----------- | ------ |
| 200 | ok | **application/json**: { **"BulkMatchResponse"**: { **"fileId"**: integer, **"status"**: { **"statusCode"**: string, **"statusDescription"**: string } } }<br> |
| 401 | Unauthorized |  |
| 403 | Forbidden |  |
| 404 | Not Found |  |

### [POST] /visasuppliermatchingservice/v1/upload
**Upload**

Supplier Matching Service Bulk upload

#### Parameters

| Name | Located in | Description | Required | Schema | Style | Explode |
| ---- | ---------- | ----------- | -------- | ------ | ----- | ------- |
| countryCode | query | Default Country Code for this file | Yes | string | form | Yes |

#### Responses

| Code | Description | Schema |
| ---- | ----------- | ------ |
| 201 | Created | **application/json**: { **"201"**: object, **"BulkMatchResponse"**: { **"fileId"**: integer, **"status"**: { **"statusCode"**: string, **"statusDescription"**: string } } }<br> |
| 401 | Unauthorized |  |
| 403 | Forbidden |  |
| 404 | Not Found |  |

### [GET] /visasuppliermatchingservice/v1/download
**Download**

Supplier Matching Service Bulk Match download

#### Parameters

| Name | Located in | Description | Required | Schema | Style | Explode |
| ---- | ---------- | ----------- | -------- | ------ | ----- | ------- |
| inputFileId | query | Id of request file supplied at time of upload | Yes | string | form | Yes |

#### Responses

| Code | Description | Schema |
| ---- | ----------- | ------ |
| 200 | ok | **application/json**: { **"ByteArrayResource"**: { **"byteArray"**: [ object ] } }<br> |
| 401 | Unauthorized |  |
| 403 | Forbidden |  |
| 404 | Not Found |  |