VCES - Validate Endpoint with Documentation not in sync

[tibalogh]

Dear Team,

I might have found some inconsistencies between the documentation (see the link below), and the functionality of sandbox service endpoint.

Link to the documentation: https://developer.visa.com/capabilities/vces/reference#tag/Visa-Card-Eligibility-Service/operation/V...

Sandbox service endpoint: https://sandbox.api.visa.com/visacardeligibilityservices/v1/cardeligibility/validate

• requestTimeStamp format: regarding to the documentation, the timestamp should be in this format: "mm/dd/yyyy hh:mm:ss a", but it responds "Vendor RequestTimeStamp format error" status description, statusCode: "103".
  
  request example: 

{
    "permanentAccountNumber": "4000000000000013",
    "vendorUniqueId": "14096_TstVDPPgm1",
    "numberOfAdditionalRedemptions": 2,
    "requestTimeStamp": "5/4/2022 5:04:50 PM",
    "correlationId": "7a9d1ed7-78cf-4de5-bafd-0dc59fce742d",
    "extendedData": "asddd"
}​

Response: 

{
    "statusCode": "103",
    "statusDescription": "Vendor RequestTimeStamp format error",
    "CorrelationId": "1651e4cb-440b-456b-9e3f-01b3c1e34fd7",
    "responseTimeStamp": "5/4/2022 3:08:01 PM",
    "eligibilityLevel": "0",
    "cardId": "0"
}​

X-CORRELATION-ID:1651676691_006_553997613_-74979967j5_VDP_WS

Using ISO format in the responseTimeStamp, the response was successful:
Request: 

{
    "permanentAccountNumber": "4000000000000013",
    "vendorUniqueId": "14096_TstVDPPgm1",
    "numberOfAdditionalRedemptions": 2,
    "requestTimeStamp": "2022-05-04T15:14:13.630Z",
    "correlationId": "9badec7e-afa0-47dd-940e-28dd2ca161d9",
    "extendedData": "asddd"
}​

Response: 

{
    "statusCode": "000",
    "statusDescription": "Success",
    "CorrelationId": "9badec7e-afa0-47dd-940e-28dd2ca161d9",
    "responseTimeStamp": "5/4/2022 3:14:14 PM",
    "eligibilityLevel": "0",
    "isEligible": "True",
    "cardId": "311"
}​

Which format should I use in production? Can you please clarify this?

• In the documentation a number of other fields are shown I cannot see in the service's response, for example cardBenefits, productSubType, redemptionDetails, etc. 
  Is it possible to make all those fields shown in the documentation available in the response?
  How can I achieve that?
• According to the documentation, the response message field name "CorrelationId" should start with lowercase letter: "correlationId".
• Can you please provide test data, where eligibility level is "1" or "2" as well?

Thank you in advance,

Tibor  

[jenn_kh]

We appreciate you bringing this to our attention, @tibalogh. We have let our team know and an agent will follow up with any information as soon as possible. -Jenn

[API_Products]

Hi @tibalogh,

I've logged incident INC13514536 for our engineering team to investigate the issue. I'll provide an update once I hear back from them. 

[tibalogh · Accepted solution]

Thank you Diana

I've made further tests, and found, that the first bulletpoint with the requestTimeStamp format is not a problem anymore. When I first tried the given format, I used my local time, which was in GMT+2 timezone. Now I have tried using UTC time, and the format was accepted by the service. Maybe it would be worth mentioning it in the documentation, that the request timestamp should be in UTC.

[API_Products]

Hi @tibalogh,

Thanks for letting me know the issue is fixed. I've communicated your request to have our documentation updated to our engineering team. 

[tibalogh]

Hi @API_Products , thank you for your message.

I only wanted to let you know that the first question is no more an issue, but there were others in my original question. Should I ask them in a different thread? They were: 

• In the documentation a number of other fields are shown I cannot see in the service's response, for example cardBenefits, productSubType, redemptionDetails, etc. 
  Is it possible to make all those fields shown in the documentation available in the response?
  How can I achieve that?
• According to the documentation example response, the response message field name "CorrelationId" should start with lowercase letter: "correlationId".
• Can you please provide test data, where eligibility level is "1" or "2" as well?

[API_Products]

Hi @tibalogh,

The VCES product team is most likely going to postpone any API documentation update until the future. Regarding documentation on cardBenefits, productSubType, redemptionDetails, etc., that will not be provided in the near future unless you (the client) establishes a formal business relationship with Visa. 

[API_Products]

Hi @tibalogh,

Our engineering team has received information from the VCES team that the Sandbox is very limited in terms of testing scope. If you wish to pursue additional information about VCES, you should contact your regional product office. We have opened up a ticket to have the documentation corrected for some of the VCES case issues.