Outgoing VOP request object

Send a VOP request to verify your counterparty's information

ℹ️
About our solution
Numeral's VOP solution is based on currently available information and technical documentation from the European Payments Council (EPC), including the Verification Of Payee Scheme Rulebook, the Verification Of Payee Inter-PSP API Specifications, and the API Security Framework.
Numeral is still waiting for the publication of critical EPC documentations, including the EPC's Directory Services documentation to finalise and launch its VOP solution.
Numeral has expressed its intent to participate as a routing and verification mechanism (RVM) via the EPC's call for interest and is listed as a compliant RVM.
Numeral actively participates in the EPC's RVM information sessions and intends to participate in the EPC's pilot phases.

Attribute	Description
`object`	Always `outgoing_vop_request`.
`id`	The ID of the outgoing VOP request.
`status`	The status of the outgoing VOP request. Can be`created`, `sent`, `processed`, `failed`. See the outgoing VOP request lifecycle here.
`status_details`	More information about the outgoing VOP request's status.
`party_name`	The name of the counterparty. For natural persons: first and last names For moral persons: commercial name
`party_identification_type`	The identification type of the counterparty. Only applicable to legal persons.
`party_identification`	The identification code of the counterparty. Only applicable to legal persons.
`party_account`	The account number of the counterparty. Must be an IBAN.
`party_agent`	The BIC of the counterparty's PSP.
`unstructured_remittance_information`	Additional information about the counterparty.
`result`	Result provided by the responding PSP. It is composed of: `value`: can be `match`, `close_match` (only applicable to natural persons), `no_match` or `impossible_match` `suggested_name`: in case of `value` = `close_match` , name of the counterparty as reported by the responding PSP.
`created_at`	The UTC timestamp of the creation of the outgoing VOP request.
`metadata`	Additional data in JSON `key: value` format.
`bank_data`	Technical and standardised information about the VOP request. It is composed of: `X-Request-ID`: unique ID of the request communicated to the responding PSP, equal to the `id` attribute `X-RequestTimestamp`: the UTC timestamp of the sending of the outgoing VOP request to the responding PSP `X-ResponseTimestamp`: the UTC timestamp of the responsefrom the responding PSP

{
  "object": "outgoing_vop_request",
  "id": "20c75a77-de31-460d-a321-4f2421805943",
  "status": "created",
  "status_details": null,
  "party_name": "Jean Dupont",
  "party_identification_type": null,
  "party_identification": null,
  "party_account": "FR5012739000308682265435N36",
  "party_agent": "BANKFRPP",
  "unstructured_remittance_information": null,
  "result": null,
  "created_at": "2025-01-28T15:26:36Z",
  "metadata":{
    "country": "FR"
  },
  "bank_data": {
    "X-Request-ID": null,,
    "X-RequestTimestamp": null,
    "X-ResponseTimestamp": null
  }
}

{
  "object": "outgoing_vop_request",
  "id": "20c75a77-de31-460d-a321-4f2421805943",
  "status": "created",
  "status_details": null,
  "party_name": null,
  "party_identification_type": "lei",
  "party_identification": "123456789",
  "party_account": "FR5012739000308682265435N36",
  "party_agent": "BANKFRPP",
  "unstructured_remittance_information": null,
  "result": null,
  "created_at": "2025-01-28T15:26:36Z",
  "metadata":{
    "country": "FR"
  },
  "bank_data": {
    "X-Request-ID": null,,
    "X-RequestTimestamp": null,
    "X-ResponseTimestamp": null
  }
}

{
  "object": "outgoing_vop_request",
  "id": "20c75a77-de31-460d-a321-4f2421805943",
  "status": "sent",
  "status_details": null,
  "party_name": "Jean Dupont",
  "party_identification_type": null,
  "party_identification": null,
  "party_account": "FR5012739000308682265435N36",
  "party_agent": "BANKFRPP",
  "unstructured_remittance_information": null,
  "result": null,
  "created_at": "2025-01-28T15:26:36Z",
  "metadata":{
    "country": "FR"
  },
  "bank_data": {
    "X-Request-ID": "20c75a77-de31-460d-a321-4f2421805943",,
    "X-RequestTimestamp": "2025-01-28T15:26:40Z",
    "X-ResponseTimestamp": null
  }
}

{
  "object": "outgoing_vop_request",
  "id": "20c75a77-de31-460d-a321-4f2421805943",
  "status": "processed",
  "status_details": null,
  "party_name": "Jean Dupont",
  "party_identification_type": null,
  "party_identification": null,
  "party_account": "FR5012739000308682265435N36",
  "party_agent": "BANKFRPP",
  "unstructured_remittance_information": null,
  "result": {
    "value": "match",
    "suggested_name": null
  },
  "created_at": "2025-01-28T15:26:36Z",
  "metadata":{
    "country": "FR"
  },
  "bank_data": {
    "X-Request-ID": "20c75a77-de31-460d-a321-4f2421805943",,
    "X-RequestTimestamp": "2025-01-28T15:26:40Z",
    "X-ResponseTimestamp": "2025-01-28T15:26:45Z"
  }
}

{
  "object": "outgoing_vop_request",
  "id": "20c75a77-de31-460d-a321-4f2421805943",
  "status": "failed",
  "status_details": "party_agent does not participate in vop",
  "party_name": "Jean Dupont",
  "party_identification_type": null,
  "party_identification": null,
  "party_account": "FR5012739000308682265435N36",
  "party_agent": "BANKFRPP",
  "unstructured_remittance_information": null,
  "result": null,
  "created_at": "2025-01-28T15:26:36Z",
  "metadata":{
    "country": "FR"
  },
  "bank_data": {
    "X-Request-ID": null,,
    "X-RequestTimestamp": null,
    "X-ResponseTimestamp": null
  }
}

ℹ️About our solution

ℹ️
About our solution