20 March 2025
Version History V2.0
Welcome to the Version History for the VoP Bulk API Specification. This page provides a detailed overview of the updates made in this release, aimed at aligning formats, refining descriptions, and implementing select functional enhancements.
Reviewing this version history will help you understand the scope of the updates and assess any necessary adjustments for a smooth transition to V2.0.
Each section outlines the changes made, including both the previous and updated values, along with a classification of the change type:
- Format Change: Adjustments to improve standardisation, readability, or consistency. These changes do not impact integration logic.
- Functional Change: Modifications that alter API behaviour or data handling. These changes may require updates to your integration.
Auth API Specification Changes
Functional Changes
| Section | Field | Old Value | New Value | Comment |
|---|---|---|---|---|
| How does it work? | Link | API key | client_id | Updated terminology to be more accurate |
| How does it work? | Link | secret | client_secret | Updated terminology to be more accurate |
Format Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Introduction | Link | N/A | Additional description added with reference to RFC 6749 |
| Go directly to | Link | N/A | Updated links |
| Request Headers | Link | Empty | Added additional heading |
| Request Headers | Link | Headers | Request Headers |
| Request Headers | Link | Empty | Added examples of headers |
| Request Headers | Note | Replace "hostValue"... | Bullet point removed |
| Request Headers | Content-Type | Type: application/x-www-form-urlencoded | Type: String |
| Request Headers | Authorization | Type: Basic | Type: String |
| Request Body | data-urlencode | Type: grant_type=client_credentials | Type: String |
| Request Body | data-urlencode | Empty | Added example |
| Response Body | All Fields | Empty | Added all fields and descriptions |
Bulk Request Changes
Functional Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Request Body | identification | Type: String | Type: Object |
| Request Body | organisationId | Type: Array of Object | Type: Object |
| Request Body | anyBIC | Empty | Added |
| Request Body | others | Type: Object | Type: Array of Objects |
| Request Body | iban | N/A | Added Mandatory tag |
| Request Body | partyAgent | N/A | Conditional |
| Request Body | partyAgent.financialInstitutionId | N/A | Conditional & added usage rule |
| Request Body | requestingAgent | N/A | Added Mandatory tag |
| Request Body | requestingAgent.financialInstitutionId | N/A | Added Mandatory tag |
| Request Body | requestingAgent.financialInstitutionId.bicfi | N/A | Added Mandatory tag |
| Request Body | Examples | N/A | Updated examples with unstructuredRemittanceInformation as an Array of Strings |
| Response Body | Examples | Empty | Added "advancedInfo" object |
| Response Body | Examples | Empty | Additional examples added including one with anyBIC |
| Enumeration List | nameSchemeCode | Link | Updated descriptions and formats |
Format Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Go directly to | Link | N/A | Updated links |
| Request Headers | Link | Empty | Added additional heading |
| Request Headers | Link | Headers | Request Headers |
| Request Headers | Content-Type | Type: application/x-ndjson | Type: String |
| Request Headers | Content-Type | N/A | Added example |
| Request Headers | Authorization | Type: Bearer | Type: String |
| Request Headers | Accept | Empty | Added field to be more accurate |
| Request Headers | Accept-Language | nameSuggestion | matchedName |
| Request Body | name | N/A | Added Conditional tag |
| Request Body | identification | N/A | Added Conditional tag |
| Request Body | All Optional Fields | N/A | Added Optional tag |
| Request Body | lei | N/A | Added Conditional tag |
| Request Body | schemeNameCode | N/A | Added Conditional tag |
| Request Body | schemeNameProprietary | N/A | Added Conditional tag |
| Request Body | Examples | Combined | Split examples between request and response |
| Response Headers | Link | Empty | Added additional header |
| Response Headers | Link | Empty | Added Response Headers |
Status Request Changes
Functional Changes
There are no functional changes.
Format Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Go directly to | Link | N/A | Updated links |
| Request Headers | Content-Type | Empty | Added to be more accurate |
| Request Headers | Authorization | Type: Bearer | Type: String |
| Request Headers | Accept | Empty | Added to be more accurate |
| Request Headers | Accept-Language | nameSuggestion | matchedName |
| Request Headers | Example | N/A | Added additional fields to example |
| Response Headers | Link | Added headers and examples to be more accurate | |
| Response Body | status | N/A | Added descriptions of each status |
Results Request Changes
Functional Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Response Body | advancedInfo | Empty | New object added to cater for the SurePay Plus service |
| Response Body | Examples | Empty | Added "advancedInfo" object |
| Response Body | Examples | Empty | Additional examples added |
Format Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Go directly to | Link | N/A | Updated links |
| Request Headers | Content-Type | Type: application/x-ndjson | Type: String |
| Request Headers | Content-Type | N/A | Added example |
| Request Headers | Authorization | Type: Bearer | Type: String |
| Request Headers | Accept | Empty | Added field to be more accurate |
| Request Header | Examples | Empty | Added example |
| Response Headers | X-Request-Id | N/A | Updated description |
| Response Headers | Content-Type | Type: application/json | Type: String |
| Response Headers | Content-Type | N/A | Added example |
| Response Headers | Example | Empty | Added example |
| Response Body | All Fields | N/A | Updated grammar & spelling, aligned descriptions with VoP Gateway |
| Response Body | additionalPartyInformation | Tag: Add on Feature | Tag: Conditional |
| Response Body | Examples | N/A | Updated title of each example to be more descriptive |
Status and Error Codes Changes
Functional Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Error Response Body | code | N/A | Added link to possible values |
| Error Response Body | type | N/A | Added format of max 70 characters |
| Error Response Body | title | N/A | Added link to possible values |
| Error Response Body | title | N/A | Added format of max 70 characters |
| File Response Body | code | N/A | Added link to possible values |
| File Response Body | type | N/A | Added format of max 70 characters |
| File Response Body | title | N/A | Added link to possible values |
| File Response Body | title | N/A | Added format of max 70 characters |
| Functional Errors | Error Message Codes | TIMESTAMP_INVALID | Removed |
| Functional Errors | Error Message Codes | Empty | INTERNAL_SERVER_ERROR added with description |
| Error Table | unstructuredRemittanceInformation | N/A | Removed from mandatory error description as its not mandatory |
| Error Table | Internal Server Error | N/A | Removed as its covered in Functional Errors |
| Error Table | CLIENT_INCONSISTENT | N/A | Removed as its covered in Functional Errors |
| Error Table | Certificate Items | N/A | Removed |
| Error Table | Duplicated_Field | N/A | Removed |
Format Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Go directly to | Link | N/A | Updated links |
| Status and Error Codes | Link | N/A | Expanded across entire page, fixed spelling and grammar |
| Response Headers | Link | N/A | Added example |
| Response Body | All Fields | N/A | Added Optional tag |
| File Headers | Link | N/A | Added example |
| File Body | All Fields | N/A | Added Optional tag |
Switch Check Changes
Functional Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Request Body | Examples | N/A | Updated examples with unstructuredRemittanceInformation as an Array of Strings |
| Response Body | Example | N/A | Added "additionalPartyInformation" object as per VoP Gateway Spec |
| Response Body | Example | N/A | Added "advancedInfo" object as per VoP Gateway Spec, this shows an example of the SurePay Plus offering in conjunction with the SwitchCheck |
Format Changes
| Section | Field | Old Value | New Value |
|---|---|---|---|
| Introduction | Link | Spelling & grammar fixes | |
| Response Body | Description | account object | additionalPartyInformation object |
| Response Body | switchingInformation | Tag: Conditionally Returned | Tag: Conditional |
| Response Body | switchingServiceForAccount | Tag: Conditionally Returned | Tag: Conditional |
| Response Body | switchedIban | Tag: Conditionally Returned | Tag: Conditional |
| Response Body | Example | N/A | New Example Added: VoP Standard with SwitchCheck add-on, this shows the response without the "advancedInfo" object |
| Response Body | Example Name | Inactive account switched | VoP Plus with SwitchCheck add-on: Natural Person with Inactive Account |
| Response Body | Example Name | Active account switched | VoP Plus with SwitchCheck add-on: Natural Person with Active Account |