Verification of Payee

Verification of Payee (VoP) test data

Verification of Payee (VoP) is a banking service that allows you to verify the account holder's name before making a payment. In the sandbox environment, we provide specific test IBANs that will return predictable responses to help you test your VoP integration.

Test IBANs for VoP

When creating a verification of payee in the sandbox environment, you can use the following test IBANs to receive specific responses:

IBAN	Expected Response	Description
ES3369400001160227909902	`rejected`	This IBAN will always result in a rejected verification
ES4469400001180255458867	`failed` (NO MATCH)	This IBAN will always result in a failed verification
ES1869400001170413506237	`confirmed` (CLOSE_MATCH)	This IBAN will always result in a confirmed verification with a close match
Any other IBAN	`confirmed` (MATCH)	Any IBAN not listed above will result in a confirmed verification with a match

Important: Only the three specific IBANs listed above will return predictable responses. Any other IBAN used in a VoP request will result in a confirmed (MATCH) status.

How it works

Create a verification of payee with one of the test IBANs above
Wait for processing - The verification will be processed automatically after a short delay
Check the result - The verification will transition to either confirmed, failed or rejected status based on the IBAN used

Example responses

Using the rejected IBAN (ES3369400001160227909902)

{
  "id": "vop_123",
  "counterparty": {
    "name": "Test Company S.L.",
    "taxid": "B12345678",
    "account": {
      "identifiers": [{
        "type": "iban",
        "iban": "ES3369400001160227909902"
      }],
      "bank": {
        "name": "Devengo S.L.",
        "bic": "DEVNESM2XXX"
      }
    }
  },
  "status": "rejected",
  "created_at": "2024-01-15T10:30:00Z",
  "response": {
    "code": "verification_check_not_possible",
    "reason": "AC01"
  }
}

Using the failed IBAN (ES4469400001180255458867)

{
  "id": "vop_124",
  "counterparty": {
    "name": "Test Company S.L.",
    "taxid": "B12345678",
    "account": {
      "identifiers": [{
        "type": "iban",
        "iban": "ES4469400001180255458867"
      }],
      "bank": {
        "name": "Devengo S.L.",
        "bic": "DEVNESM2XXX"
      }
    }
  },
  "status": "failed",
  "created_at": "2024-01-15T10:30:00Z",
  "response": {
    "code": "no_match"
  }
}

Using the confirmed close match IBAN (ES1869400001170413506237)

{
  "id": "vop_125",
  "counterparty": {
    "name": "Test Company S.L.",
    "taxid": "B12345678",
    "account": {
      "identifiers": [{
        "type": "iban",
        "iban": "ES1869400001170413506237"
      }],
      "bank": {
        "name": "Devengo S.L.",
        "bic": "DEVNESM2XXX"
      }
    }
  },
  "status": "confirmed",
  "created_at": "2024-01-15T10:30:00Z",
  "response": {
    "code": "close_match",
    "matched_name": "Company S.L.",
  }
}

Using any other IBAN

{
  "id": "vop_126",
  "counterparty": {
    "name": "Test Company S.L.",
    "taxid": "B12345678",
    "account": {
      "identifiers": [{
        "type": "iban",
        "iban": "ES7269400001110020685532"
      }],
      "bank": {
        "name": "Devengo S.L.",
        "bic": "DEVNESM2XXX"
      }
    }
  },
  "status": "confirmed",
  "created_at": "2024-01-15T10:30:00Z",
  "response": {
    "code": "match"
  }
}

Integration testing

Use these test IBANs to verify that your application correctly handles:

✅ Confirmed verifications - Ensure your app correctly processes match and close match VoP results.
❌ Failed verifications - Ensure your app correctly processes no match VoP results.
⚠️ Rejected verifications - Verify that your app properly handles unexpected rejections.

This allows you to build robust error handling and user experience flows before moving to production.