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

Общая информация

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

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

Использование этой возможности вписывается в схемы проверки действительности платёжного инструмента (подробнее) и не требует со стороны веб-сервиса каких-либо дополнительных действий помимо работы с расширенным составом параметров в запросах и оповещениях (подробнее далее). Для подключения этой возможности следует обращаться к курирующему менеджеру ecommpay.

Особенности и ограничения

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

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

Формат запросов

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

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

{
  "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"
  },
  //с указанием реквизитов платёжного инструмента (по спецификации)
}

Формат оповещений

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

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

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

{
  "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=="
}

Дополнительные материалы