Visa Developer Community

Helper

API Example contradicts VISA Documentation

https://developer.visa.com/capabilities/visa_direct/reference#visa_direct__funds_transfer__v1__pullf...

At the right side in the link above, the visa documentation provides a handy API interaction tool: https://www.dropbox.com/s/jyqoiopy3ih4vv7/Screenshot%202018-02-06%2018.57.30.png?dl=0

For cardAcceptorAddressCounty however, it provides the value: "San Mateo" whereas the documentation states: 

county

Conditional

string | Length: 3

Note:county of the money transfer operator/Originator.

Required if cardAcceptor:address:country is "US".

 
Questions:
Am I correct to assume that the API call value: "San Mateo" is invalid?
Am I correct to assume that the value instead should be a FIPS county code?
Am I correct to assume that likewise the value for cardAcceptorState is invalid, as it is 
  • "state": "CA"

whereas it is supposed to be the FIPS state code instead?

5 REPLIES 5
Visa Dev Moderator

Re: API Example contradicts VISA Documentation

Hello,

 

Thanks for your inquiry and I really like the  question you're asking too. To answer your question, the Visa Direct county code uses the FIPS code. Please see the below sample code:

 

Sample Code:

 

"\"cardAcceptor\":{"

                                       + "\"name\":\"John Smith\","

                                       + "\"terminalId\":\"13655392\","

                                       + "\"idCode\":\"VMT200911026070\","

                                       + "\"address\":{"

                                                       + "\"state\":\"CA\","

                                                       + "\"county\":\"081\","

                                                       + "\"country\":\"USA\","

                                                       + "\"zipCode\":\"94105\""

 

Also, please take a look at the Visa Direct documentation description and refer to the ISO country codes related to this API.

 

Request & Response Codes > ISO Country Codes

https://developer.visa.com/request_response_codes

 

 

Thank you,

Diana

Was your question answered? Don't forget to click on "Accept as Solution" to help other devs find the answer to the same question.

Thanks,
Diana

Tags (1)
Helper

Re: API Example contradicts VISA Documentation

Hi Diana,

 

  1. Could you be so kind as to provide me with a direct link to the example code you provided? I am not able to see it anywhere in the documentation. 
  2. Could you be so kind as to provide me with a direct link to the VISA Direct documentation that explicitly states that county/state fields within cardAcceptor attribute are FIPS codes?
  3. Could you kindly clarify what ISO Country codes have to do with my question?

Thanks.

Visa Dev Moderator

Re: API Example contradicts VISA Documentation

Hi,

 

Thanks for continually asking questions in the community forum. Please see this link for the sample code I provided as it addresses questions 1 and 2 - https://developer.visa.com/vdpguide#sample_code_for_project.

 

For information on county, please also refer to Docs > Visa Direct > API Reference - https://developer.visa.com/capabilities/visa_direct/reference  

 

county

Conditional

string | Length: 3

Note: county of the money transfer operator/Originator.

Required if cardAcceptor:address:country is "US".

 

Also, the ISO Country Codes documentation was provided because it can be helpful to your project. Hope you're having a good day!

 

 

Thank you,

Diana

Was your question answered? Don't forget to click on "Accept as Solution" to help other devs find the answer to the same question.

Thanks,
Diana

Highlighted
Helper

Re: API Example contradicts VISA Documentation

Thank you for the link to the sample code. Even though it is classified under /legacy, the example does highly indicate that a FIPS code is to be used. 

 

However, I would like to be 100% certain about this and it seems to be that the documentation is not precise on the matter.

 

Next, the matter of state code is still remaining. In the example documentation you linked to, the value 'CA' is utilized. This is highly inconsistent as a FIPS code is 5 digits long, 3 for county 2 for state. So to utilize the FIPS code for county, but to use something else for state is highly confusing. 

 

 

 

Visa Dev Moderator

Re: API Example contradicts VISA Documentation

Hi,

 

Thanks for letting me know your thoughts on this. I'll let the product team know what you've found and please do write another post if there's anything else you'd like to share with us.

 

Thank you,

Diana

Was your question answered? Don't forget to click on "Accept as Solution" to help other devs find the answer to the same question.

Thanks,
Diana