.. meta:: :description: /api/v2/get-card-info API endpoint Payneteasy: получает информацию о BIN, эмитенте, платёжной системе и стране карты по референсу карты через API. .. _/api/v2/get-card-info/: /api/v2/get-card-info ###################### .. role:: ex .. role:: code Введение ^^^^^^^^^^^^ Для интеграции используйте запрос интеграционной среды :code:`HTTPS POST` к указанным ниже :ref:`URL` и :ref:`параметрам`. Для аутентификации используйте :ref:`SHA-1`. См. :ref:`статусы`. .. _api_v2_get-card-info_request_url: API URL ^^^^^^^^ .. note:: | Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее. .. list-table:: :widths: 50, 50 :header-rows: 1 :class: longtable * - Интеграционная среда - Производственная среда * - :ex:`https://sandbox.payneteasy.ru/paynet/api/v2/get-card-info/ENDPOINTID` - :ex:`https://gate.payneteasy.ru/paynet/api/v2/get-card-info/ENDPOINTID` * - :ex:`https://sandbox.payneteasy.ru/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID` - :ex:`https://gate.payneteasy.ru/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID` .. _api_v2_get-card-info_request_parameters: Параметры запроса ^^^^^^^^^^^^^^^^^^ .. note:: | Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded. .. list-table:: :widths: 30, 45, 25 :header-rows: 1 :class: longtable * - Название параметра - Описание - Значение * - :code:`login` - Логин Присоединяющейся стороны в Системе. - | ``Необходимость``: Обязательно | ``Тип``: String | ``Длина``: 20 * - :code:`cardrefid` - ИД ссылки на карту, полученный на шаге :ref:`Регистрации Карты`. - | ``Необходимость``: Обязательно | ``Тип``: String | ``Длина``: 20 * - :code:`control` - | Контрольная сумма, сгенерированная :ref:`SHA-1`. Строка для подписи представляет собой объединение следующих параметров: | 1. Параметр запроса: :ex:`login` | 2. Параметр запроса: :ex:`cardrefid` | 3. :ex:`merchant_control` (Контрольный ключ, присвоенный аккаунту Присоединяющейся стороны в системе шлюза Payneteasy). - | ``Необходимость``: Обязательно | ``Тип``: String | ``Длина``: 128 .. _api_v2_get-card-info_response_parameters_url: Параметры ответа ^^^^^^^^^^^^^^^^^^^ .. note:: | Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра. .. list-table:: :widths: 25, 75 :header-rows: 1 :class: longtable * - Information Параметры ответа - Описание * - :code:`type` - | Тип ответа. Может быть :ex:`get-card-info-response`, :ex:`validation-error`, :ex:`error`. | Если type равен :ex:`error`, параметры :ex:`error-message` и :ex:`error-code` содержат детали ошибки. * - :code:`serial-number` - Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. * - :code:`card-printed-name` - Карта holder's название. * - :code:`bin` - Bank Identification Number. * - :code:`last-four-digits` - Последние четыре цифры :ex:`PAN`. * - :code:`expire-year` - Год срока действия карты. * - :code:`expire-month` - Месяц срока действия карты. * - :code:`result-3d` - Описание: 3DS completion result. * - :code:`error-message` - Если статус :ex:`validation-error` или :ex:`error`, этот параметр содержит причину отклонения или детали ошибки. * - :code:`error-code` - Код ошибки в случае статуса :ex:`validation-error` или :ex:`error`. Пример запроса ^^^^^^^^^^^^^^^ .. code-block:: text POST /paynet/api/v2/get-card-info/46750 HTTP/1.1 Host: https://sandbox.payneteasy.ru User-Agent: curl/7.85.0 Accept: */ Content-Length: 77 Content-Type: application/x-www-form-urlencoded Connection: close &login=Test &cardrefid=1461665 &control=f8ffd7dac9e334799862da0e9190387510d43ff7 Пример успешного ответа ^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: javascript HTTP/1.1 200 Server: server Date: Thu, 02 Feb 2023 11:21:39 GMT Content-Type: text/html;charset=utf-8 Connection: close Vary: Accept-Encoding X-XSS-Protection: 1 X-Content-Type-Options: nosniff Strict-Transport-Security: max-age=31536000 Content-Language: en-US Strict-Transport-Security: max-age=31536000 Content-Length: 193 type=get-card-info-response &serial-number=00000000-0000-0000-0000-000002e0d218 &card-printed-name=CARD+HOLDER &bin=453897 &last-four-digits=6732 &expire-year=2099 &expire-month=12 &result-3d=F Пример неуспешного ответа ^^^^^^^^^^^^^^^^^^^^^ .. code-block:: javascript HTTP/1.1 200 Server: server Date: Thu, 02 Feb 2023 11:26:22 GMT Content-Type: text/html;charset=utf-8 Connection: close Vary: Accept-Encoding X-XSS-Protection: 1 X-Content-Type-Options: nosniff Strict-Transport-Security: max-age=31536000 Content-Language: en-US Strict-Transport-Security: max-age=31536000 Content-Length: 136 type=validation-error &serial-number=00000000-0000-0000-0000-000002e0d21f &error-message=End+point+with+id+99999+not+found &error-code=3 .. only:: openapi_doc_enabled Open API Collection ^^^^^^^^^^^^^^^^^^^ Open this method in the OpenAPI Reference .. raw:: html View in OpenAPI Коллекция Postman ^^^^^^^^^^^^^^^^^^ .. raw:: html :file: ../_static/Postman/Postman_recurrent.html Конструктор запросов ^^^^^^^^^^^^^^^ .. raw:: html :file: ../_static/examples/recurrent_transaction_Get_Card_Info_Debug.html