Versioning and Change log

Breaking changes

Version 5 dynamic statement narratives.

• you must now submit narrative in yourintelligentanddynamicverification request
• this is no longer a breaking change. narrative is now an optional field as of 02/15/2021

Breaking changes

Version 4 introduces strict parsing.

• header change to "Content-Type: application/vnd.worldpay.verifications.accounts-v4+json"
• sending any fields not recorded in our documentation returns anerror

Breaking changes

Version 3 introduces transactionReference.

• header change to "Content-Type: application/vnd.worldpay.verifications.accounts-v3+json"
• new mandatorytransactionReferencefield

Breaking changes

Version 2 introduces verificationAddress and the removal of the recurring endpoint.

• header change to "Content-Type: application/vnd.worldpay.verifications.accounts-v2+json"
• verifications:recurring action link and https://try.access.worldpay.com/verifications/accounts/intelligent/recurring resource link removed
• cardOnFile endpoint now returnscardOnFileAuthorizeandrecurringAuthorizeaction links in the response
• merchant.reference renamed to merchant.entity
• billingAddress renamed to verificationAddress

The field fundingType in the paymentInstrument object of yourresponsecan now have the following additional values:

• chargeCard
• prepaid
• deferreddebit

We have added these to the already existing values of debit and credit.

You now have an additional field of category in the card section of youroneTime responseif you have opted in to receive it. This field populates data from the cardbin:productType field value.

• You can now sendverification requestsagainst US bank accounts to ACH endpoint:

  • https://try.access.worldpay.com/verifications/accounts/ach

• You can now submit the CVC as an optional field in theverification request with tokenfor both oneTime and cardOnFile endpoints.

  • https://try.access.worldpay.com/verifications/accounts/intelligent/oneTime
  • https://try.access.worldpay.com/verifications/accounts/intelligent/cardOnFile
  • https://try.access.worldpay.com/verifications/accounts/dynamic/oneTime
  • https://try.access.worldpay.com/verifications/accounts/dynamic/cardOnFile

• You can now supply storedCredentials.reason as an optional field for both cardOnFile endpoints:

  • https://try.access.worldpay.com/verifications/accounts/intelligent/cardOnFile
  • https://try.access.worldpay.com/verifications/accounts/dynamic/cardOnFile

• The paymentInstrument.cardHolderName field is no longer mandatory in v5 requests.

• The narrative block is no longer a mandatory field in v5 requests to cater for upstream services

You can now submit your v4 and v5intelligentanddynamicverification with a decrypted Apple Pay paymentInstrument. This only applies to the cardOnFile endpoints:

https://try.access.worldpay.com/verifications/accounts/intelligent/cardOnFile

https://try.access.worldpay.com/verifications/accounts/dynamic/cardOnFile

• we are returningpaymentInstrumentin verified and notVerified responses for enabled merchants

• you can now submit the following values for authentication.version in your3DSrequest:

  • for 3DS1 - 1.0.2
  • for 3DS2 - 2.1.0 or 2.2.0

• we are returningriskFactorsin verified and notVerified responses

• you can now sendverification requestswith a token to both cardOnFile endpoints:

  • https://try.access.worldpay.com/verifications/accounts/intelligent/cardOnFile
  • https://try.access.worldpay.com/verifications/accounts/dynamic/cardOnFile

• you can now sendverification requestswith a token to both oneTime endpoints:

  • https://try.access.worldpay.com/verifications/accounts/intelligent/oneTime
  • https://try.access.worldpay.com/verifications/accounts/dynamic/oneTime

• recurringSaleaction link is now returned in the cardOnFile verification responses. This allows for recurring sale transactions.