Quote for EU VOP check payments

Beneficiary validation is required when payments are in EUR, provided that the customer, beneficiary bank, and any applicable third-party remitter are located within the Eurozone.

Add Payment

  1. Add the Eurozone country code to the beneficiary bank and third-party fields in the payment request. A list of Eurozone country codes is provided below.

Country/territoryCountry Code
BelgiumBE
BulgariaBG
Canary IslandsES
CroatiaHR
CyprusCY
Czech RepublicCZ
DenmarkDK
EstoniaEE
FinlandFI
FranceFR
French GuianaGF
GermanyDE
GibraltarGI
GreeceGR
GuadeloupeGP
GuernseyGG
HungaryHU
IcelandIS
IrelandIE
Isle Of ManIM
ItalyIT
JerseyJE
LatviaLV
LiechtensteinLI
LithuaniaLT
LuxembourgLU
MadeiraPT
MaltaMT
MartiniqueMQ
MayotteYT
MonacoMC
NetherlandsNL
NorwayNO
PolandPL
PortugalPT
RéunionRE
RomaniaRO
Saint BarthélemyBL
Saint Martin (French part)MF
Saint Pierre and MiquelonPM
San MarinoSM
SlovakiaSK
SloveniaSI
SpainES
SwedenSE
SwitzerlandCH
Vatican City StateVA
Åland IslandsFI
AndorraAD
AustriaAT
AzoresPT

  1. The payment object should include the IBAN value "iban":"DE28503399002244668800" and set the paymentCurrencyCode to EUR.

Validate Payment

  1. After submitting payment, it is essential to use the get payment details API to validate the transaction. The API will provide a valid response that confirms the payment details.

Valid Response:

{
    "totalPages": 1,
    "currentPage": 1,
    "totalCount": 1,
    "hasPrevious": false,
    "hasNext": false,
    "payments": [
        {
            "id": "5L7VxslQVmuqDagt9AqCPnBPYq1SG6bS",
            "batchId": "4A4FVIuTip4TWIMMdvXaVhlghcnZ9gkG",
            "status": "Created",
            "partnerReference": "partner",
            "paymentReference": "aa",
            "createdOn": "2025-09-24T13:21:28Z",
            "lastUpdatedOn": "2025-09-24T13:21:28Z"
        }
    ]
}
  1. The Masspay returned a not accepted message if the IBAN was not provided in the payment request, indicating that the payment was not processed.
{
    "totalPages": 1,
    "currentPage": 1,
    "totalCount": 1,
    "hasPrevious": false,
    "hasNext": false,
    "payments": [
        {
            "id": "YAMCushucfNqBrq32ZYaxNcgYhGDkiT7",
            "status": "NotAccepted",
            "errorCode": "1003:iban"
        }
    ]
}

Requesting Quote

  1. Adding a valid payment in the Add Payment step returns a response with validationOfBeneficiary, including match type, match description, and other details.

The text outlines the components involved in the validationOfBeneficiary process, which includes key elements such as paymentId, name, iban, matchScore, matchType, matchDescription, validationMessage, and a disclaimer message.

below are responses for CMTC, MTCH, NMTC, NTVL, NO

{
    "expirationIntervalInSec": 0,
    "validationOfBeneficiary": [
        {
            "paymentId": "jP54rrHcB7a1siUpbKIfiYH0fMd9UHIx",
            "name": "S Weber",
            "iban": "DE28503399002244668800",
            "matchScore": "0.5",
            "matchType": "CMTC",
            "matchDescription": "Close Match",
            "validationMessage": "The provided Payee Name and account number of the beneficiary almost match. The name of the beneficiary associated with the provided bank account number is: Sophie Weber. This gives you a chance to double-check and confirm that your money is going to the right person or business. You can cancel the payment, update the details and send again with a different payment ID. Or you can requote to proceed.",
            "disclaimer": "If you go ahead with this request, the name will remain the same. Please note that authorizing the credit transfer may lead to transferring the funds to a payment account not held by the beneficiary which you have indicated.If you chose to ignore this notification and proceed, Convera shall not be held liable for the execution of the credit transfer to an unintended payee and you may not be entitled to receive a refund for the amount transferred."
        }
    ]
}
{
    "expirationIntervalInSec": 0,
    "validationOfBeneficiary": [
        {
            "paymentId": "UMXXOhqsItSejejNIPJqO8a3e4CZhuRF",
            "name": "Sophie Weber",
            "iban": "DE28503399002244668800",
            "matchScore": "1",
            "matchType": "MTCH",
            "matchDescription": "Strong Match",
            "validationMessage": "The payee name and payment identifier which you have provided match exactly, please requote to proceed."
        }
    ]
}
{
    "expirationIntervalInSec": 0,
    "validationOfBeneficiary": [
        {
            "paymentId": "VL8Yd2GN9BE6oACXSbXmmbjPXEDMG9x2",
            "name": "Sofy",
            "iban": "DE28503399002244668800",
            "matchScore": "0",
            "matchType": "NMTC",
            "matchDescription": "No Match",
            "validationMessage": "Warning: The provided Payee Name and account number of the beneficiary do not match. Please note that authorizing the payment may lead to transferring the funds to an account not held by the intended beneficiary. You can cancel the payment, update the details and send again with a different payment ID. Or you can requote to proceed.",
            "disclaimer": "Only proceed with the payment if you are certain the payee details are correct. By choosing to proceed with this payment this might affect your rights to a refund and our liability as your payment service provider."
        }
    ]
}
{
    "expirationIntervalInSec": 0,
    "validationOfBeneficiary": [
        {
            "paymentId": "yd6QUY7fGVBKV9vzRA0gPW3Tt4I1kkha",
            "name": "Sophie Weber",
            "iban": "DE28503399002244668899",
            "matchScore": "0",
            "matchType": "NOAP",
            "matchDescription": "Verification Not Possible",
            "validationMessage": "The verification check cannot be completed. It cannot be confirmed that the provided Payee Name matches the account number. We cannot verify these details, if you are unsure, you have the correct information, please cancel the payment and once verified resend with a new payment ID. Or you can proceed at your own risk, by requoting.",
            "disclaimer": "If you choose to ignore this notification and proceed, Convera shall not be held liable for the execution of the payment to an unintended payee and you may not be entitled to receive a refund for the amount transferred."
        }
    ]
}
{
    "expirationIntervalInSec": 0,
    "validationOfBeneficiary": [
        {
            "paymentId": "M5yeYjvzz6F9JHG5P49F9jXN7pX9g2O7",
            "name": "Otto Larsen",
            "iban": "DE15801640509362882000",
            "matchScore": "0",
            "matchType": "NTVL",
            "matchDescription": "Not Validated",
            "validationMessage": "The verification check cannot be completed at this time. We cannot verify these details, if you are unsure, you have the correct information, please cancel the payment and once verified resend with a new payment ID. Or you can proceed at your own risk, by requoting.",
            "disclaimer": "Only proceed with the payment if you are certain the payee details are correct. By choosing to proceed with this payment, you understand and agree that you are doing so at your own risk. Convera shall not be held liable for the execution of the credit transfer to an unintended payee and you may not be entitled to receive a refund for the amount transferred."
        }
    ]
}
  1. If the VOP API is down or cannot fetch a VOP response, the Quote API returns the following error:
{
    "errorDescription": "An error occurred while trying to validate the beneficiary. Please try after some time",
    "errorCode": "1239"
}
  1. Requote - step 5 did not create a quote, we validate the payment request via the VOP API. After receiving the VOP response, the customer can decide to proceed with a requote. This step creates the actual quote.
{
    "id": "46EEF8AF-AE1E-4370-8035-80F3CA5B5CE6",
    "expirationIntervalInSec": 120,
    "createdOn": "2025-09-24T12:33:32Z",
    "status": "Created",
    "lastUpdatedOn": "2025-09-24T12:33:32Z",
    "quotedItems": [
        {
            "isDirectRate": true,
            "rate": 0.8644,
            "rateInverted": 1.1569,
            "decimalsDirect": 4,
            "decimalsIndirect": 4,
            "tradeAmount": 10100,
            "settlementAmount": 8730,
            "tradeCurrency": "USD",
            "settlementCurrency": "EUR"
        }
    ],
    "validationOfBeneficiary": [
        {
            "paymentId": "ZHwIzDg2nO4FUHNzRrGg6cDbEW6jfzWv",
            "name": "S Weber",
            "iban": "DE28503399002244668800",
            "matchScore": "0.5",
            "matchType": "CMTC",
            "matchDescription": "Close Match",
            "validationMessage": "The provided Payee Name and account number of the beneficiary almost match. The name of the beneficiary associated with the provided bank account number is: Sophie Weber. This gives you a chance to double-check and confirm that your money is going to the right person or business. You can cancel the payment, update the details and send again with a different payment ID. Or you can requote to proceed.",
            "disclaimer": "If you go ahead with this request, the name will remain the same. Please note that authorizing the credit transfer may lead to transferring the funds to a payment account not held by the beneficiary which you have indicated.If you chose to ignore this notification and proceed, Convera shall not be held liable for the execution of the credit transfer to an unintended payee and you may not be entitled to receive a refund for the amount transferred."
        }
    ]
}

VOP Match Validations

  1. Below is a list of match validations for the VOP API
  • MTCH: Strong Match
  • CMTC: Close Match
  • NMTC: No Match
  • NOAP: Verification Not Possible
  • NTVL: Not Validated

Validation messages and disclaimers link with the flow type and match. See the table below for more information.


Match TypeFlow TypeValidation MsgDisclaimer
MTCHCOUPLEDThe payee name and payment identifier which you have provided match exactly, please requote to proceed.NULL
MTCHSTANDALONEThe payee name and payment identifier which you have provided match exactly.NULL
CMTCCOUPLEDThe provided Payee Name and account number of the beneficiary almost match. The name of the beneficiary associated with the provided bank account number is: 0. This gives you a chance to double-check and confirm that your money is going to the right person or business. You can cancel the payment, update the details and send again with a different payment ID. Or you can requote to proceed.If you go ahead with this request, the name will remain the same. Please note that authorizing the credit transfer may lead to transferring the funds to a payment account not held by the beneficiary which you have indicated. If you chose to ignore this notification and proceed, Convera shall not be held liable for the execution of the credit transfer to an unintended payee and you may not be entitled to receive a refund for the amount transferred.
CMTCSTANDALONEThe provided Payee Name and account number of the beneficiary almost match. The name of the beneficiary associated with the provided bank account number is: 0. This gives you a chance to double-check and confirm that your money is going to the right person or business.If you proceed with approving this request, Payee Name will be updated to the suggested name upon final authorization of the payment.
NMTCCOUPLEDWarning: The provided Payee Name and account number of the beneficiary do not match. Please note that authorizing the payment may lead to transferring the funds to an account not held by the intended beneficiary. You can cancel the payment, update the details and send again with a different payment ID. Or you can requote to proceed.Only proceed with the payment if you are certain the payee details are correct. By choosing to proceed with this payment this might affect your rights to a refund and our liability as your payment service provider.
NMTCSTANDALONEWarning: The provided Payee Name and account number of the beneficiary do not match. Please note that authorizing the payment may lead to transferring the funds to an account not held by the intended beneficiary.Only proceed with the payment if you are certain the payee details are correct. By choosing to proceed with this payment this might affect your rights to a refund and our liability as your payment service provider.
NOAPCOUPLEDThe verification check cannot be completed. It cannot be confirmed that the provided Payee Name matches the account number. We cannot verify these details, if you are unsure, you have the correct information, please cancel the payment and once verified resend with a new payment ID. Or you can proceed at your own risk, by requoting.If you choose to ignore this notification and proceed, Convera shall not be held liable for the execution of the payment to an unintended payee and you may not be entitled to receive a refund for the amount transferred.
NOAPSTANDALONEThe verification check cannot be completed. It cannot be confirmed that the provided Payee Name matches the account number.If you choose to ignore this notification and proceed, Convera shall not be held liable for the execution of the payment to an unintended payee and you may not be entitled to receive a refund for the amount transferred.
NTVLCOUPLEDThe verification check cannot be completed at this time. We cannot verify these details, if you are unsure, you have the correct information, please cancel the payment and once verified resend with a new payment ID. Or you can proceed at your own risk, by requoting.Only proceed with the payment if you are certain the payee details are correct. By choosing to proceed with this payment, you understand and agree that you are doing so at your own risk. Convera shall not be held liable for the execution of the credit transfer to an unintended payee, and you may not be entitled to receive a refund for the amount transferred.

We need different error codes for VOP-related errors, as follows:


Error CodeContextCondition / ScenarioError Description
1238Standalone APIInvalid VOP request dataInvalid request data. The currency code is invalid
1239Standalone APIUnable to retrieve VOP responseUnable to retrieve validation of payee response.
1240Quote RequestBad RequestThe verification check cannot be completed at this time, please re-quote if you want to proceed with the payment. Disclaimer: will update soon,
1241Quote RequestOther validation errors (System Down - VOP API down)An error occurred while trying to validate the beneficiary, please re-quote if you want to proceed with the payment. Disclaimer: will update soon.

VOP Webhooks

After VOP validation, we send the VOP response to Webhook. This event is called vop.validationCompleted.

Below is the webhook response:

  1. Strong Match - MTCH
{
  "id": "61171e0f-e3f1-40b3-a010-222c53990be4",
  "eventType": "vop.validationCompleted",
  "createdOnUTC": "2025-09-22T10:42:51Z",
  "summary": "VOP validation has been completed.",
  "resource": {
    "paymentId": "UMXXOhqsItSejejNIPJqO8a3e4CZhuRF",
    "accountName": "Sophie Weber",
    "accountNumber": "DE28503399002244668800",
    "matchScore": "1",
    "matchType": "MTCH",
    "matchDescription": "Strong Match",
    "disclaimer": null,
    "validationMessage": "The payee name and payment identifier which you have provided match exactly, please requote to proceed.",
    "partnerName": "MPCPL3",
    "customerName": "MOSESFRMPCPL3",
    "batchId": "LpqdAWxpGQmdaqmUrKGC9SnzMRU2L06Q",
    "validationCompletedOnUtc": "2025-09-22T10:42:51.5905159Z"
  }
}
  1. CMTC - Close Match
{
  "id": "87c2462a-7488-46e3-a557-99584b67350b",
  "eventType": "vop.validationCompleted",
  "createdOnUTC": "2025-09-22T10:49:27Z",
  "summary": "VOP validation has been completed.",
  "resource": {
    "paymentId": "ZTYjfccWArkUN8tjOJdH33mKe7SLAMx2",
    "accountName": "S Weber",
    "accountNumber": "DE28503399002244668800",
    "matchScore": "0.5",
    "matchType": "CMTC",
    "matchDescription": "Close Match",
    "disclaimer": "If you go ahead with this request, the name will remain the same. Please note that authorizing the credit transfer may lead to transferring the funds to a payment account not held by the beneficiary which you have indicated.If you chose to ignore this notification and proceed, Convera shall not be held liable for the execution of the credit transfer to an unintended payee and you may not be entitled to receive a refund for the amount transferred.",
    "validationMessage": "The provided Payee Name and account number of the beneficiary almost match. The name of the beneficiary associated with the provided bank account number is: Sophie Weber. This gives you a chance to double-check and confirm that your money is going to the right person or business. You can cancel the payment, update the details and send again with a different payment ID. Or you can requote to proceed.",
    "partnerName": "MPCPL3",
    "customerName": "MOSESFRMPCPL3",
    "batchId": "rmcZcOcU0JDeQ2o0WvQ610xHXKCMkFRS",
    "validationCompletedOnUtc": "2025-09-22T10:49:26.5184657Z"
  }
  1. NMTC - No Match
{
  "id": "245b3d2b-eabe-4087-9bc1-3cf8e0dde17a",
  "eventType": "vop.validationCompleted",
  "createdOnUTC": "2025-09-22T10:56:37Z",
  "summary": "VOP validation has been completed.",
  "resource": {
    "paymentId": "VL8Yd2GN9BE6oACXSbXmmbjPXEDMG9x2",
    "accountName": "Sofy",
    "accountNumber": "DE28503399002244668800",
    "matchScore": "0",
    "matchType": "NMTC",
    "matchDescription": "No Match",
    "disclaimer": "Only proceed with the payment if you are certain the payee details are correct. By choosing to proceed with this payment this might affect your rights to a refund and our liability as your payment service provider.",
    "validationMessage": "Warning: The provided Payee Name and account number of the beneficiary do not match. Please note that authorizing the payment may lead to transferring the funds to an account not held by the intended beneficiary. You can cancel the payment, update the details and send again with a different payment ID. Or you can requote to proceed.",
    "partnerName": "MPCPL3",
    "customerName": "MOSESFRMPCPL3",
    "batchId": "7Kpd3F3ZbwpsYQrH76bqMd49Xw3oLEO9",
    "validationCompletedOnUtc": "2025-09-22T10:56:37.217398Z"
  }
}
  1. NOAP - Verification Not Possible
{
  "id": "132b4192-b772-44ff-a672-d6f3a4fd415f",
  "eventType": "vop.validationCompleted",
  "createdOnUTC": "2025-09-22T11:02:02Z",
  "summary": "VOP validation has been completed.",
  "resource": {
    "paymentId": "yd6QUY7fGVBKV9vzRA0gPW3Tt4I1kkha",
    "accountName": "Sophie Weber",
    "accountNumber": "DE28503399002244668899",
    "matchScore": "0",
    "matchType": "NOAP",
    "matchDescription": "Verification Not Possible",
    "disclaimer": "If you choose to ignore this notification and proceed, Convera shall not be held liable for the execution of the payment to an unintended payee and you may not be entitled to receive a refund for the amount transferred.",
    "validationMessage": "The verification check cannot be completed. It cannot be confirmed that the provided Payee Name matches the account number. We cannot verify these details, if you are unsure, you have the correct information, please cancel the payment and once verified resend with a new payment ID. Or you can proceed at your own risk, by requoting.",
    "partnerName": "MPCPL3",
    "customerName": "MOSESFRMPCPL3",
    "batchId": "Xf22mIJ0IBNCaDxAV9ogK9ahrINmYPpk",
    "validationCompletedOnUtc": "2025-09-22T11:02:01.9045342Z"
  }
}
  1. NTVL - Not Validated
{

  "id": "7e44c474-ada1-42a8-ada7-3ebf5eab3df2",
  "eventType": "vop.validationCompleted",
  "createdOnUTC": "2025-09-22T11:06:34Z",
  "summary": "VOP validation has been completed.",
  "resource": {
    "paymentId": "M5yeYjvzz6F9JHG5P49F9jXN7pX9g2O7",
    "accountName": "Otto Larsen",
    "accountNumber": "DE15801640509362882000",
    "matchScore": "0",
    "matchType": "NTVL",
    "matchDescription": "Not Validated",
    "disclaimer": "Only proceed with the payment if you are certain the payee details are correct. By choosing to proceed with this payment, you understand and agree that you are doing so at your own risk. Convera shall not be held liable for the execution of the credit transfer to an unintended payee and you may not be entitled to receive a refund for the amount transferred.",
    "validationMessage": "The verification check cannot be completed at this time. We cannot verify these details, if you are unsure, you have the correct information, please cancel the payment and once verified resend with a new payment ID. Or you can proceed at your own risk, by requoting.",
    "partnerName": "MPCPL3",
    "customerName": "MOSESFRMPCPL3",
    "batchId": "2I0goayvnxn4fC8Ri8keqw8SPccucAzJ",
    "validationCompletedOnUtc": "2025-09-22T11:06:33.980505Z"
  }
}

Convera Logo

© 2022 All Rights Reserved