Versioning and Change log

This log details any breaking and non-breaking API changes we have released for our Verifications service.

Prerequisite: Make yourself familiar with ourAPI Principlesto ensure a resilient integration.

Versioning log

Breaking changes

Version 5 dynamic statement narratives.

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 will return 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

Note: You can find documentation for all versionshere.

Change log (Non-breaking changes)

  • you can now submit yourintelligentanddynamicverification requests to our verifications:recurring and verifications:dynamicRecurring endpoints
  • 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.