---
title: "Verificar titular del medio de pago"
method: POST
path: "/payment-method/{payment-method}/verify-holder"
tags: ["Common operations", "Operaciones comunes"]
---

# Verificar titular del medio de pago

`POST /payment-method/{payment-method}/verify-holder`

Mediante este endpoint se puede verificar la titularidad de un **source** (tarjeta o cuenta bancaria) comparando el nombre del titular indicado con el titular real del medio de pago. Devuelve el estado final del intento y, cuando se ha podido realizar, el resultado de coincidencia (`MATCH`, `PARTIAL_MATCH`, `NO_MATCH`).

## Path parameters

- `payment-method` 'card' | 'dynamic_card' | 'bank', required

## Parameters

- `#/paths/~1/get/parameters/0` — unresolved $ref

## Request body

- object — Cuerpo de la petición para verificar la titularidad de un medio de pago (Source Holder Verification).
  - `signature` Signature, required — unresolved $ref
  - `source_uuid` Uuid, required — unresolved $ref
  - `service` ServiceUuid, required — unresolved $ref
  - `verification_method` 'NAME' | 'IDENTIFICATION_NUMBER' — Método utilizado para verificar la titularidad del medio de pago. Si no se especifica, se utiliza NAME.
  - `holder` object, required — Datos del titular que se usarán para la verificación.
    - `first_name` string, required — Nombre del titular a verificar.
    - `last_name` string — Apellidos del titular a verificar.
    - `identification_number` string — Identificador legal del titular del medio de pago (por ejemplo, NIF, DNI, pasaporte o número de registro de empresa).

## Response `200`

OK

- object — Resultado de la verificación del titular del medio de pago.
  - `message` string, required — Nombre del código HTTP de respuesta.
  - `code` number, required — Código de respuesta.
  - `current_time` string, required — Fecha y hora de la petición.
  - `verification` object, required — Resultado del intento de verificación SHV.
    - `uuid` string, uuid, required — Identificador único de la verificación realizada.
    - `status` 'PERFORMED' | 'NOT_PERFORMED' | 'NOT_SUPPORTED' | 'FAILED' | 'ERROR', required — Estado final del intento de verificación.
    - `match_result` 'MATCH' | 'PARTIAL_MATCH' | 'NO_MATCH', nullable, required — Resultado de coincidencia cuando la verificación ha sido realizada.
    - `error` string, nullable, required — Error producido durante la verificación si aplica.
    - `policy_action` string, nullable, required — No aplica en este endpoint, siempre será null.
    - `verification_method` 'NAME' | 'IDENTIFICATION_NUMBER', required — Método utilizado para verificar la titularidad del medio de pago.

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/paylands/apis/documentacio-n-de-paylands.md) · [All operations](https://skmtc.net/paylands/apis/documentacio-n-de-paylands/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylands/documentacio-n-de-paylands/revisions/6bf9c0ba354b/schema)