.. meta:: :description: Проверка PAN Eligibility в SBC: определяет, поддерживает ли карта OCT (push-платежи) и денежные переводы, до инициации Payout или Transfer. .. _pan_eligibility: PAN Eligibility ############### .. role:: ex .. role:: code Введение ^^^^^^^^^^^^ Сервисы проверки PAN позволяют Присоединяющейся стороне определить, подходит ли карта для Money Transfer (как отправляющая или получающая), и получить расширенную информацию об эмитенте и продукте карты до отправки финансового запроса. PAN Eligibility Direct Flow ^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. uml:: :align: center skinparam roundcorner 20 skinparam sequenceArrowThickness 1 skinparam maxmessagesize 1200 skinparam sequenceParticipant underline actor Payer participant "Connecting Party" as A participant SBC as B autonumber Payer -> A: Checkout activate A A -> B: /api/v2/pan-eligibility/send/ activate B A -> B: /api/v2/pan-eligibility/receive/ A -> B: /api/v2/pan-eligibility/both/ B --> A: Order ID B -> B: Process\npan-eligibility group Get Final Status == Receive Connecting Party Callback == A <- B: Callback with Final Status A --> B: HTTP 200 deactivate B == Order Status Request == A -> B: Get Status by Order ID activate B B --> A: Final Status deactivate B end A --> Payer: Show result deactivate Payer deactivate A | (2,3,4) О реализации запроса прямого процесса проверки PAN см. :ref:`/api/v2/pan-eligibility/`. Информацию о проверке PAN можно запросить для карты Плательщика (Отправителя), карты Получателя или обеих карт сразу. | (5) Для реализации обратного вызова с обработкой финального статуса см. :ref:`Обратный вызов Присоединяющейся Стороны`. | (7) Для реализации запроса статуса заказа см. :ref:`/api/v2/status/`. Статус следует запрашивать несколько раз с интервалом 3-5 секунд, пока в ответе не будет получен финальный статус. PAN Eligibility Form Flow ^^^^^^^^^^^^^^^^^^^^^^^^^ .. uml:: :align: center skinparam roundcorner 20 skinparam sequenceArrowThickness 2 skinparam ParticipantPadding 30 actor Payer as Customer participant "Connecting Party\nwebsite" as Merchant participant "Payment Gateway" as g autonumber Customer -> Merchant: Checkout activate Merchant == Purchase payment request == Merchant -> g: api/v2/pan-eligibility/send-form activate g Merchant -> g: api/v2/pan-eligibility/receive-form Merchant -> g: api/v2/pan-eligibility/both-form g --> Merchant: Redirect-url, orderId deactivate g Merchant -> Customer: Provide redirect-url \nto payer’s browser deactivate Merchant activate Customer Customer -> g: GET redirect-url deactivate Customer activate g g --> Customer: Payment Form deactivate g activate Customer Customer -> g: Submit form deactivate Customer activate g g --> g: Process PAN Eligibility == Final redirect of customer == g -> Customer: Connecting Party website redirect_url activate Customer Customer -> Merchant: POST redirect_url\nstatus, orderid deactivate Customer activate Merchant group Get Final Status == Receive Connecting Party Callback == Merchant <- g: Сallback with final status g <-- Merchant: HTTP 200 deactivate g == Order Status Request == Merchant -> g: api/v2/status activate g g --> Merchant: Response \nstatus, order-stage deactivate g end Merchant --> Customer: Show result deactivate Merchant | (2,3,4) О реализации запроса процесса проверки PAN через форму см. :ref:`/api/v2/pan-eligibility-form/`. Информацию о проверке PAN можно запросить для карты Плательщика (Отправителя), карты Получателя или обеих карт сразу. | (5) Для реализации обратного вызова с обработкой финального статуса см. :ref:`Обратный вызов Присоединяющейся Стороны`. | (7) Для реализации запроса статуса заказа см. :ref:`/api/v2/status/`. Статус следует запрашивать несколько раз с интервалом 3-5 секунд, пока в ответе не будет получен финальный статус. PAN Eligibility Callback ^^^^^^^^^^^^^^^^^^^^^^^^ Параметры обратного вызова ~~~~~~~~~~~~~~~~~~~ Дополнительные параметры отправляются в callback-уведомлениях для транзакций PAN Eligibility. Подробнее см. :ref:`Параметры callback Присоединяющейся стороны`. .. list-table:: :widths: 40, 60 :header-rows: 1 :class: longtable * - Параметр - Описание * - :code:`status` - Подробности см. в :ref:`status_list`. * - :code:`serial-number` - Серийный номер запроса. * - :code:`client_orderid` - Идентификационный номер транзакции, присовенный Присоединяющейся Стороной. * - :code:`paynet-order-id` - Идентификатор заказа, заданный SBC. * - :code:`processor-tx-id` - Идентификатор транзакции, присвоенный процессором. * - :code:`type` - Тип транзакции, например :ex:`sale`, :ex:`reversal`, :ex:`chargeback`. * - :code:`sending-card-type` - Тип отправляющей карты (:ex:`VISA`, :ex:`MASTERCARD`). * - :code:`sending-cardholder` - Держатель отправляющей карты. * - :code:`sending-bin` - Идентификационный номер банка отправляющей карты. * - :code:`sending-last-four-digits` - Последние 4 цифры отправляющей карты. * - :code:`sending-eligible` - Подходит ли отправляющая карта для отправки средств. Возможные значения: :ex:`true`/:ex:`false`/:ex:`unknown`. * - :code:`sending-ica` - Описание: The sending card ICA. * - :code:`sending-bank-name` - Название банка отправляющей карты. * - :code:`sending-currency-code` - Код валюты отправляющей карты. * - :code:`sending-country-code` - Код страны отправляющей карты. * - :code:`sending-acceptance-brand-code` - Код бренда принятия отправляющей карты. * - :code:`sending-acceptance-brand-name` - Название бренда принятия отправляющей карты. * - :code:`sending-product-brand-code` - Код бренда продукта отправляющей карты. * - :code:`sending-product-brand-name` - Название бренда продукта отправляющей карты. * - :code:`receiving-card-type` - Тип получающей карты (:ex:`VISA`, :ex:`MASTERCARD`). * - :code:`receiving-bin` - Идентификационный номер банка получающей карты. * - :code:`receiving-last-four-digits` - Последние 4 цифры получающей карты. * - :code:`receiving-eligible` - Подходит ли получающая карта для отправки средств. Возможные значения: :ex:`true`/:ex:`false`/:ex:`unknown`. * - :code:`receiving-ica` - ICA получающей карты. * - :code:`receiving-bank-name` - Название банка получающей карты. * - :code:`receiving-currency-code` - Код валюты получающей карты. * - :code:`receiving-country-code` - Код страны получающей карты. * - :code:`receiving-acceptance-brand-code` - Код бренда принятия получающей карты. * - :code:`receiving-acceptance-brand-name` - Название бренда принятия получающей карты. * - :code:`receiving-product-brand-code` - Код бренда продукта получающей карты. * - :code:`receiving-product-brand-name` - Название бренда продукта получающей карты. * - :code:`error-code` - Код ошибки. * - :code:`error-message` - Error Message. * - :code:`control` - | Контрольная сумма, сгенерированная :ref:`SHA-1`. Строка для подписи представляет собой объединение следующих параметров: | 1. Параметр обратного вызова: :ex:`status`. | 2. Параметр обратного вызова: :ex:`orderid`. | 3. Параметр обратного вызова: :ex:`merchant_order`. | 4. :ex:`merchant_control` (Контрольный ключ, присвоенный аккаунту Торговца в Платёжном Шлюзе SBC). Callback Macros ~~~~~~~~~~~~~~~ Простой URL callback содержит все параметры, перечисленные в :ref:`Параметры обратного вызова`. Настраиваемый URL позволяет Присоединяющейся стороне определять собственные имена параметров, тогда как фактические значения параметров задаются с помощью макросов в формате :ex:`${parameter_name}`. Доступные макросы перечислены в :ref:`Callback Macros`. .. list-table:: :widths: 44, 15, 41 :header-rows: 1 :class: longtable * - Макрос имени поля - Field Value Macro - Описание * - :code:`${status}` - n/a - Статус транзакции: :ex:`одобрена`, :ex:`отклонена`, :ex:`обрабатывается`. * - :code:`${serial-number}` - n/a - Уникальный номер, присваиваемый сервером SBC конкретному запросу от Присоединяющейся стороны. * - :code:`${client-order-id}` - n/a - Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. * - :code:`${paynet-order-id}` - n/a - Идентификатор заказа, созданный SBC. * - :code:`${processor-tx-id}` - n/a - Идентификатор транзакции, сгенерированный Процессором. * - :code:`${type}` - n/a - Тип транзакции, например :ex:`sale`, :ex:`return`, :ex:`chargeback` и т.д. * - :code:`${sending-card-type}` - n/a - Тип отправляющей карты (:ex:`VISA`, :ex:`MASTERCARD`). * - :code:`${sending-cardholder}` - n/a - Держатель отправляющей карты. * - :code:`${sending-bin}` - n/a - Идентификационный номер банка отправляющей карты. * - :code:`${sending-last-four-digits}` - n/a - Последние 4 цифры отправляющей карты. * - :code:`${sending-eligible}` - n/a - Подходит ли отправляющая карта для отправки средств. Возможные значения: :ex:`true`/:ex:`false`/:ex:`unknown`. * - :code:`${sending-ica}` - n/a - Описание: The sending card ICA. * - :code:`${sending-bank-name}` - n/a - Название банка отправляющей карты. * - :code:`${sending-currency-code}` - n/a - Код валюты отправляющей карты. * - :code:`${sending-country-code}` - n/a - Код страны отправляющей карты. * - :code:`${sending-acceptance-brand-code}` - n/a - Код бренда принятия отправляющей карты. * - :code:`${sending-acceptance-brand-name}` - n/a - Название бренда принятия отправляющей карты. * - :code:`${sending-product-brand-code}` - n/a - Код бренда продукта отправляющей карты. * - :code:`${sending-product-brand-name}` - n/a - Название бренда продукта отправляющей карты. * - :code:`${receiving-card-type}` - n/a - Тип получающей карты (:ex:`VISA`, :ex:`MASTERCARD`). * - :code:`${receiving-bin}` - n/a - Идентификационный номер банка получающей карты. * - :code:`${receiving-last-four-digits}` - n/a - Последние 4 цифры получающей карты. * - :code:`${receiving-eligible}` - n/a - Подходит ли получающая карта для отправки средств. Возможные значения: :ex:`true`/:ex:`false`/:ex:`unknown`. * - :code:`${receiving-ica}` - n/a - ICA получающей карты. * - :code:`${receiving-bank-name}` - n/a - Название банка получающей карты. * - :code:`${receiving-currency-code}` - n/a - Код валюты получающей карты. * - :code:`${receiving-country-code}` - n/a - Код страны получающей карты. * - :code:`${receiving-acceptance-brand-code}` - n/a - Код бренда принятия получающей карты. * - :code:`${receiving-acceptance-brand-name}` - n/a - Название бренда принятия получающей карты. * - :code:`${receiving-product-brand-code}` - n/a - Код бренда продукта получающей карты. * - :code:`${receiving-product-brand-name}` - n/a - Название бренда продукта получающей карты. * - :code:`${error-code}` - n/a - Код ошибки. * - :code:`${error-message}` - n/a - Error Message. * - :code:`${control}` - n/a - | Контрольная сумма, сгенерированная :ref:`SHA-1`. Строка для подписи представляет собой объединение следующих параметров: | 1. Параметр обратного вызова: :ex:`status`. | 2. Параметр обратного вызова: :ex:`orderid`. | 3. Параметр обратного вызова: :ex:`merchant_order`. | 4. :ex:`merchant_control` (Контрольный ключ, присвоенный аккаунту Торговца в Платёжном Шлюзе SBC). .. ifconfig:: "doc.payneteasy.com" in site_link ---- .. admonition:: See also :class: related-cross-link `Advanced payment technologies on the Payneteasy platform → `_ .. ifconfig:: "doc.payneteasy.ru" in site_link ---- .. admonition:: См. также :class: related-cross-link `Технологии платформы Payneteasy → `_