---
title: "Global Payee Verification (G-PV) - Validate beneficiary details globally"
method: POST
path: "/banks/{customerId}/globalvalidate"
tags: ["Bank Resource"]
---

# Global Payee Verification (G-PV) - Validate beneficiary details globally

`POST /banks/{customerId}/globalvalidate`

## Request

- Base URL: `https://masspaysandbox.api.convera.com/masspayments`
- URL: `https://masspaysandbox.api.convera.com/masspayments/banks/{customerId}/globalvalidate`
- Auth: none declared

Performs Global Payee Verification (G-PV) for beneficiary details across multiple countries. Supports GB (COP with IBAN or localAccountNumber+sortCode), AU (localAccountNumber+sortCode), and IBAN-based countries (AT, DE, etc.). Returns per-beneficiary validation results including match scores and validation status.

## Path parameters

- `customerId` string, required

## Request body

- GlobalVopValidationRequestData: Global VOP V2 validation request. Validates beneficiary details across supported countries (GB, AU, AT, DE, etc.).
  - `beneficiaryDetails` GlobalVopBeneficiaryRequestItem[], required: Array of beneficiary details to validate
    - `countryCode` string, required: ISO 3166-1 alpha-2 country code of the beneficiary's bank account
    - `creditorName` string, required: Name of the account holder to validate against
    - `iban` string: International Bank Account Number. Required if localAccountNumber and sortCode are not provided.
    - `localAccountNumber` string: Local bank account number. Must be used together with sortCode. Alternative to iban.
    - `sortCode` string: Bank sort code / routing number. Must be used together with localAccountNumber.
    - `creditorBic` string: BIC/SWIFT code of the creditor's bank. Optional for COP (GB), may be required for SWIFT path.
    - `accountHolderType` 'personal' | 'business': Type of account holder. Required for GB and AU (COP countries). Values: personal, business.
    - `postalAddress` GlobalVopPostalAddress: Postal address of the beneficiary. Optional for most validations.
      - `addressType` string: Type of address
      - `streetName` string: Street name and number
      - `buildingName` string: Building or house name
      - `postCode` string: Postal / ZIP code
      - `townName` string: Town or city name
      - `country` string: ISO 3166-1 alpha-2 country code

## Response `200`

Validation completed. Response structure varies based on outcome.

- union
  - GlobalVopValidationSuccessResultData: Successful validation response - beneficiary details matched (MTCH, CMTC, NMTC, NOAP)
    - `beneficiaryDetails` object[]: Array of successful validation results
      - `responseCode` string: Response code indicating success (2000)
      - `responseMessage` string: Human-readable response message (e.g., ValidationSucceeded)
      - `validationStatus` 'MTCH' | 'CMTC' | 'NMTC' | 'NOAP': Validation outcome status
      - `validationResult` GlobalVopValidationResultDetail: Detailed validation result from the validation provider
        - `validatorName` string: Name of the validation service provider (e.g., IPID). Returns 'NOT AVAILABLE' when validation could not be performed.
        - `validationData` GlobalVopValidationData: Validation scoring data. reasonCode is only present for GB COP validations.
          - `matchScore` number, double: Match confidence score (0.0 to 1.0)
          - `matchScoreDescription` string: Human-readable description of the match score
          - `reasonCode` string: COP-specific reason code. Only present for GB COP validations. Values: MATC (Match), BAMM (Business Account Mismatch), PAMM (Personal Account Mismatch), etc.
      - `accountDetails` GlobalVopAccountDetails: Account details echoed back in the validation response
        - `accountNumber` string: The account identifier used for validation. Returns the IBAN if IBAN was provided, or the localAccountNumber if that was used.
        - `name` string: The creditor name echoed from the request
        - `referenceId` string: Unique reference ID for this beneficiary validation (system-generated UUID)
  - GlobalVopValidationNtvlResultData: Not Validated (NTVL) response - validation could not be performed at this time
    - `beneficiaryDetails` object[]: Array of NTVL validation results (no responseCode present)
      - `responseMessage` string: Message indicating validation was not possible (e.g., Data could not be validated this time.)
      - `validationStatus` 'NTVL': Always NTVL for this response type
      - `validationResult` object: Validation result with validatorName set to NOT AVAILABLE
        - `validatorName` string: Always 'NOT AVAILABLE' for NTVL responses
      - `accountDetails` GlobalVopAccountDetails: Account details echoed back in the validation response
        - `accountNumber` string: The account identifier used for validation. Returns the IBAN if IBAN was provided, or the localAccountNumber if that was used.
        - `name` string: The creditor name echoed from the request
        - `referenceId` string: Unique reference ID for this beneficiary validation (system-generated UUID)

## Other responses

- `400`: BadRequest - Only returned when requestReferenceId is missing or invalid
- `401`: Unauthorized
- `500`: Internal Server Error

## Changes

- **2026-11-03** `9604d5fa162b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/convera/apis/payments-api/changes/banks/:customerId/globalvalidate/post.md)

---

[API](https://skmtc.dev/convera/apis/payments-api.md) - [All operations](https://skmtc.dev/convera/apis/payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/convera/apis/payments-api/revisions/9604d5fa162b?raw)