Validation Of Beneficiary EU (Standalone API)

The Validate Beneficiary Resource allows the caller to verify Beneficiary details for Euro Zone Beneficiaries. This utilises the European Validation Of Beneficiary requirement to allow customers to verify the details prior to making payment. This is restricted to EU customers and partners.

The standalone API's POST API call allows for the validation of beneficiary and bank account. The response generated from this call includes key details such as name, iban, matchScore, matchType, matchDescription, validationMessage, and disclaimer. This functionality is essential for ensuring accurate and reliable banking information.

Sample Request Body: POST API call

{
    "currencyCode" : "EUR",
    "beneficiary": {
        "name" : "Marc Janssen",
        "countryCode": "BE"
    },
    "bankAccount":{
        "iban" :"BE84504754703434"
    }
  • Name: MP VOP- MTCH, API Type: Post

Response:

{
    "beneficiary": {
        "name": "Marc Janssen",
        "iban": "BE84504754703434",
        "matchScore": "1",
        "matchType": "MTCH",
        "matchDescription": "Strong Match",
        "validationMessage": "The  payee name and payment identifier which you have provided match exactly."
    }
}
  • Name: MP VOP- CMTC, API Type: Post

Response:

{
    "beneficiary": {
        "name": "M Janssen",
        "iban": "BE84504754703434",
        "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: Marc Janssen. This gives you a chance to double-check and confirm that your money is going to the right person or business.",
        "disclaimer": "If you proceed with approving this request, Payee Name will be updated to the suggested name upon final authorization of the payment."
    }
}
  • Name: MP VOP- NMTC, API Type: POST

Response:

{
    "beneficiary": {
        "name": "MJ",
        "iban": "BE84504754703434",
        "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.",
        "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."
    }
}
  • Name: MP VOP- NOAP, API Type: POST

Response:

{
    "beneficiary": {
        "name": "John Doe",
        "iban": "DE15801640509362882005",
        "matchType": "NTVL",
        "validationMessage": "The verification check cannot be completed at this time.",
        "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."
    }
}


Convera Logo

© 2022 All Rights Reserved