# Оценка достоверности имён держателей карт {#ru_gate_cardholder_name_verification}

статья о возможности сверять написания имён держателей карт с зафиксированными у эмитентов при работе через Gate

## Общая информация {#section_zq3_2q2_zhb .section}

В случаях, когда необходимо проверять действительность платёжных карт, можно дополнительно сверять написание имени держателя определённой карты с тем, которое зафиксировано у эмитента. В рамках платёжной платформы Ecommpay такая возможность поддерживается для карт платёжных систем Mastercard и Visa и включает в себя проверку в специализированных сервисах этих систем — Name Validation Service\(NVS\) для карт Mastercard и Account Name Inquiry\(ANI\) для карт Visa.

Проверка имёнможет быть актуальна в разных ситуациях \(например, перед проведением выплат или при работе с нетипичными заказами\) и позволяет дополнительно оценивать риски мошенничества и опротестования платежей. Она применима для классических карточных платежей и методов Apple Pay и Google Pay, а также при работе с сервисами Mastercard MoneySend и Visa Direct.

Использование этой возможности вписывается в схемы проверки действительности платёжного инструмента \([подробнее](ru_gate_account_verification.md)\) и не требует со стороны веб-сервиса каких-либо дополнительных действий помимо работы с расширенным составом параметров в запросах и оповещениях \(подробнее [далее](ru_gate_cardholder_name_verification.md#section_rpp_v14_3fc)\). Для подключения этой возможности следует обращаться к курирующему менеджеру Ecommpay.

## Особенности и ограничения {#section_td5_kdj_5yb .section}

При использовании оценки достоверности имён держателей карт стоит учитывать следующие особенности и ограничения:

-   Оценка может выполняться только в тех случаях, когда эмитент карты поддерживает интеграцию с соответствующим сервисом платёжной системы.
-   Со стороны эмитентов могут действовать различные правила оценки, которые могут допускать проверку только на полное соответствие имени или на полное и частичное соответствие.
-   Информация о степени соответствия имени может интерпретироваться только как справочная.Решение о проведении или отклонении платежей с учётом этой информации в каждом случае остаётся за мерчантом.
-   За каждое выполненное сопоставление имени со стороны платёжной системы взимается комиссия.В случаях, когда оценка была инициирована, но выполнить её не удалось, комиссия не взимается. Информацию об актуальных тарифах на сопоставление имён можно уточнять у курирующего менеджера Ecommpay.
-   Технически со сведениями от эмитента сопоставляются сведения, указанные в запросе на проверку действительности карты, в параметрах `first_name`, `middle_name` и `last_name` объекта `customer`. При этом для каждого из этих параметров сопоставляются только первые 35 значимых символов, исключая специальные символы и пробелы.
-   Информация о результате сопоставления передаётся к веб-сервису в итоговом оповещении о результате проверки действительности карты— в виде индикатора в параметре `name_validation_result` объекта `operation`.

## Формат запросов {#section_rpp_v14_3fc .section}

При формировании запросов на проверку действительности карты с дополнительной проверкой имени её держателя необходимо учитывать следующее:

1.  Для инициирования каждой проверки должен использоваться отдельный POST-запрос к одной из следующих конечных точек:
    -   для проверки по реквизитам карты, указанным в явном виде — `/v2/payment/card/account_verification` \([подробнее](ru_gate_account_verification.md)\);
    -   для проверки по токену, ассоциированному с картой — `/v2/payment/card/account_verification/token` \([подробнее](ru_gate_account_verification.md)\);
    -   для проверки с использованием сервиса Apple Pay — `/v2/payment/applepay/account_verification` \([подробнее](pm_applepay.md#)\);
    -   для проверки с использованием сервиса Google Pay — `/v2/payment/googlepay/account_verification` \([подробнее](pm_googlepay.md#)\).
2.  В каждом запросе в составе объекта `customer` должны передаваться следующие параметры:
    -   `first_name` — имя пользователя \(обязательно\);
    -   `middle_name` — отчество, второе или среднее имя пользователя \(при указании со стороны пользователя\);
    -   `last_name` — фамилия пользователя \(обязательно\);
    -   `name_validation` — указатель необходимости проверки имени держателя \(обязательно, со значением `true`\).
3.  Дополнительно могут использоваться любые другие параметры из указанных в спецификации используемой конечной точки API.

``` {#codeblock_dxp_wqx_jfc .language-json}
{
  "general":{
    "project_id":874,
    "payment_id":"15538406111",
    "signature":"1wR1YgD5PxxTIJfQ=="
  },
  "customer":{
    "ip_address":"192.0.2.0",
    "id":"customer_10",
    "first_name":"John",    
    "middle_name": "Jr",
    "last_name": "Doe",
    "name_validation": true //указатель необходимости проверки имени

  },
  "payment":{
    "amount":0,
    "currency":"USD"
  },
  //с указанием реквизитов платёжного инструмента (по спецификации)
}
```

## Формат оповещений {#section_gq3_n12_pfb .section}

Для итоговых оповещений о проверке платёжного инструмента вместе с оценкой достоверности имени держателя карты используется типовой формат, описание которого представлено в статье [Работа с оповещениями](ru_platform_callbacks.md#). При этом в объекте `operation` в таких оповещениях дополнительно передаётся параметр `name_validation_result` с индикатором результата сопоставления. Этот параметр может принимать следующие значения:

-   `A` — при полном соответствии сведений, представленных в запросе, со сведениями на стороне эмитента.
-   `B` — при частичном соответствии сведений, представленных в запросе, со сведениями на стороне эмитента.
-   `C` — при полном несоответствии сведений, представленных в запросе, со сведениями на стороне эмитента.
-   `U` — при невозможности сопоставления\(из-за того, что оно не поддерживается со стороны эмитента, или из-за возникших ошибок\).

В следующем примере в параметре `name_validation_result` содержится индикатор полного совпадения \(`A`\).

``` {#codeblock_dd2_1tx_jfc .language-json}
{
  "project_id":874,
  "payment":{
    "id":"15538406111",
    "type":"account_verification",
    "status":"success",
    "date":"2024-09-10T13:45:59+0000",
    "method":"card",
    "sum":{
      "amount":0,
      "currency":"USD"
    },
    "description":"Добавить карту"
  },
  "account":{
    "number":"431422******0056",
    "token":"844f84f3bdfaf2ddf006c96ffaddc09394c5d0e158f",
    "type":"visa",
    "card_holder":"JOHN DOE",
    "id":8861226,
    "expiry_month":"09",
    "expiry_year":"2028"
  },
  "customer":{
    "id":"customer_10",
    "first_name":"John",
    "middle_name":"Jr",
    "last_name":"Doe"
  },
  "recurring":{
    "id":10505,
    "currency":"USD",
    "valid_thru":"2025-09-30T00:00:00+0000"
  },
  "operation":{
    "id":4314220000000056,
    "type":"account verification",
    "status":"success",
    "date":"2024-09-10T13:45:59+0000",
    "name_validation_result": "A",   //индикатор результата сопоставления
    "created_date":"2024-09-10T13:45:57+0000",
    "request_id":"5cb898347e62b2c1-52dac6c8c",
    "provider":{
      "id":120,
      "payment_id":"306449667",
      "date":"2024-09-10T13:45:59+0000",
      "auth_code":"188591",
      "endpoint_id":120
    },
    "code":"0",
    "message":"Success"
  },
  "signature":"P9g0U+eF2QWs2A=="
}
```

## Дополнительные материалы {#section_d55_sxv_chd .section}

При работе с оценкой достоверности имён держателей карт могут быть полезны следующие материалы:

-   [Проверка платёжных инструментов](ru_gate_account_verification.md)— статья о порядке условных списаний или блокировок средств с целью проверки действительности платёжных инструментов через Gate, включая информацию о том, какие запросы и оповещения при этом актуальны в случае прямого использования платёжных карт.
-   [Классические карточные платежи](ru_pm_card_payments.md)— краткая сводка с основными сведениями о платежах с прямым использованием платёжных карт в контексте платёжных методов.
-   [Apple Pay](pm_applepay.md#)— статья о работе с платёжным методом Apple Pay, включая информацию о том, какие запросы и оповещения актуальны при проверке действительности платёжных инструментов этим методом через Gate.
-   [Google Pay](pm_googlepay.md#)— статья о работе с платёжным методом Google Pay, включая информацию о том, какие запросы и оповещения актуальны при проверке действительности платёжных инструментов этим методом через Gate.
-   [Использование сервисов Mastercard MoneySend и Visa Direct](ru_gate_money_transfer_services.md#)— статья о возможностях проведения денежных переводов в рамках специализированных сервисов от платёжных систем Mastercard и Visa.
-   [Работа с оповещениями](ru_platform_callbacks.md#)— статья о работе с программными оповещениями, позволяющими максимально оперативно получать значимую информацию о проведении каждого платежа.

**На уровень выше:**[Дополнительные возможности](ru_Gate_Additional_capabilities.md)