Работа с „сетевыми токенами“ карт платёжных систем Mastercard и Visa

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

Чтобы повысить удобство работы с данными платёжных карт и безопасность проведения платежей, отдельные платёжные системы обеспечивают возможности применения так называемых „сетевых токенов“. Каждый из таких токенов может быть получен только для карты соответствующей („родительской“) платёжной системы и только через специализированный сервис этой платёжной системы, но в дальнейшем может применяться при работе с любыми эквайерами и провайдерами, поддерживающими работу с токенами этой платёжной системы.

В платёжной платформе ecommpay поддерживается проведение отдельных типов платежей с использованием „сетевых токенов“токенов, сформированных в рамках сервисов сетевой токенизации Mastercard Secure Card on File (SCOF) и Visa Token Service (VTS) от платёжных систем Mastercard и Visa. Каждый из такихТехнически каждый из сетевых токенов этих платёжных систем представляет собой последовательность из 16 символов, которая может использоваться в запросах вместо номера карты. При этом в случаях с изменениями сведений о карте, ассоциированной с сетевым токеном (например, при перевыпуске карты), такой токен не теряет действительности, поскольку его атрибуты автоматически обновляются в соответствующем сервисе.

В рамках платёжной платформы ecommpay использование сетевых токенов может быть актуальным в тех случаях, когда эти токены уже получены в сторонних сервисах и используются на стороне мерчанта. В остальных случаях можно использовать возможности по работе с токенами через Payment Page (подробнее) и Gate (подробнее), а также возможности переноса информации о локальных токенах от других эквайеров (подробнее).

С вопросами, касающимися условий использования сетевых токенов и порядка подключения возможности работы с ними, можно обращаться к курирующему менеджеру ecommpay, с техническими вопросами, касающимися аспектов применения сетевых токенов — к настоящей документации и специалистам технической поддержки ecommpay.

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

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

  • Возможность применения сетевых токенов (для всех поддерживаемых платёжных систем) должна быть подключена для используемого проекта.

    В случае, если эта возможность не подключена для проекта, платежи с указанием сетевых токенов отклоняются с кодом ошибки 318.

  • Сетевые токены могут использоваться в ограниченном числе случаев, включая проведение разовых оплат в одну и две стадии, регистрацию и проведение повторяемых оплат с хранением платёжных данных на стороне веб-сервиса (подробнее) и проверку действительности карт.

    В других ситуациях, в частности при проведении оплат по платёжным ссылкам, при проведении повторяемых оплат с хранением данных в платформе или при проведении выплат, допустимо применять только те токены, которые сформированы непосредственно в платёжной платформе ecommpay (подробнее).

  • Управление сетевыми токенами (в том числе их формирование, обновление и получение необходимых для их использования данных) осуществляется через соответствующие специализированные сервисы.

    Для получения информации о порядке работы с такими сервисами можно обращаться к документации и специалистам этих сервисов.

  • Ответственность за корректное применение сетевых токенов и их атрибутов возлагается на мерчанта.

    При возникновении вопросов, связанных с ошибочным применением сетевых токенов, можно обращаться к курирующему менеджеру ecommpay.

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

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

  1. Для инициирования каждого такого платежа должен использоваться отдельный POST-запрос к одной из следующих конечных точек:
  2. В составе объекта card вместо сведений о платёжной карте должны передаваться следующие сведения о токене:
    • pan — токен, сформированный в специализированном сервисе сетевой токенизации;
    • year — порядковый номер года, в котором заканчивается срок действия токена (в четырёхзначном формате YYYY по григорианскому календарю);
    • month — порядковый номер месяца, в котором заканчивается срок действия токена (в виде числа, без ведущего нуля);
    • card_holder — имя держателя карты, если этот параметр обязателен для используемого проекта (это имя должно указываться в соответствии с написанием на карте; исключить его из числа обязательных можно только по согласованию с курирующим менеджером ecommpay после анализа и оценки рисков);
    • cvv — код проверки подлинности карты (обязательно во всех случаях, кроме проведения автооплат и регулярных оплат).
  3. В составе объекта token_data должны передаваться следующие параметры:
    • token_type — указатель типа токена со значением network_token (обязательно для каждого платежа);
    • cryptogram — код проверки подлинности токена, такой как Token Authentication Verification Value (TAVV), полученный в сервисе сетевой токенизации (обязательно для платежей с регистрацией повторяемых оплат и необязательно для других платежей);
    • eci — индикатор ECI, соответствующий используемому токену и полученный в сервисе сетевой токенизации (обязательно для платежей с регистрацией повторяемых оплат и необязательно для других платежей);
    • trid — идентификатор мерчанта, присвоенный при его регистрации в сервисе сетевой токенизации (необязательно).
  4. Должен передаваться параметр stored_card_type с одним из следующих значений:
    • 1 для сохранения платёжных данных или для регистрации экспресс-оплаты,
    • 2 для проведения платежа с использованием сохранённых платёжных данных или для проведения экспресс-оплаты,
    • 3 для регистрации автооплаты,
    • 4 для проведения автооплаты,
    • 5 для регистрации регулярной оплаты,
    • 6 для проведения регулярной оплаты.

    Информация о работе с повторяемыми оплатами представлена в статье Повторяемые оплаты.

  5. В случае проведения повторяемой оплаты (stored_card_type со значениями 2, 4 или 6) с использованием карты, выпущенной в Европейской экономической зоне, должен передаваться параметр scheme_id — идентификатор операции, в рамках которой была зарегистрирована эта повторяемая оплата, на стороне международной платёжной системы (Mastercard или Visa).
  6. Дополнительно могут использоваться любые другие параметры из указанных в спецификации используемой конечной точки API.

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

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