Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Первичная операция может быть проведена как с использованием обычной банковской карты, так и с использованием системы токенизации мобильных устройств, например, Apple Pay, Samsung Pay или Google Pay. В любом случае, верификация Первичная операция COF проводится с верификацией одним из возможных способов (CVC2 и 3dS 3DS или с помощью мобильного устройства) обязательна для первичной операции COF.

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

Note

Примечание. Если оплата проводится с использованием системы токенизации мобильных устройств (Apple Pay, Samsung Pay или Google Pay), то повторные операции будут аналогичны первичным, без дополнительных особенностей.


Операции CIT COF

Повторные операции могут быть инициированы плательщиком. Такие операции называются Customer Initialized Transaction (CIT).

...

При оплате очередного заказа клиент получает предложение запомнить карту для следующих покупок с использованием сервиса One Click,Программа

Сервис One Click дает возможность дает возможность постоянному клиенту предприятия совершать новые покупки без ввода данных карты, подтверждая оплату только указанием кода CVC2. Однако, при успешном проведении первичной операции COF, при последующих операциях CVC2 запрашиваться не будетдля повторных операций CIT COF (по сохраненной карте) CVC2 обычно запрашиваться не будет (за исключением тех случаев, когда делаются специальные настройки по желанию мерчанта).

Note

Для подключения предприятию возможности выполнения операций COF следует отправить соответствующую заявку в клиентский отдел по адресу support@assist.ru. В заявке должен присутствовать идентификатор предприятия (мерчанта) в системе – MerchantID.

...

При формировании очередного заказа на сайте магазина можно осуществить стандартный переход на платежную страницу АПК Ассист для оплаты сохраненной ранее картой. В этом случае магазин должен передавать данные заказа с уникальным номером клиента, т.е. в дополнение к списку параметров авторизационного запроса, необходимо передавать параметр CustomerNumber.

Note

Не допускается одновременная передача CustomerNumber с параметрами RecurringIndicator, RecurringMinAmount, RecurringMaxAmount, RecurringPeriod, RecurringMaxDate.

Все действия, связанные с оплатой сохраненной картой, выполняются на стороне АПК Ассист.

...

Note

Если предприятие не будет использовать сервис передачи платежной информации Token Pay и полученную от АПК Ассист информацию о первичном платеже в виде токена для операции CIT COF, то последующие платежи для покупателя будут выполняться стандартно по программе с использованием сервиса One Click.

Операции MIT COF

Повторные операции могут быть также инициированы предприятием. Такие операции называются Merchant Initialized Transaction (MIT).

...

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

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

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

Для реализации последующих первоначальных платежей MIT COF необходимо передать только один из дополнительных параметровдополнительные параметры:

Название

Обязательное поле

Принимаемые значения

По умолчанию

Описание

RecurringIndicator

Да

1 – рекуррентный платеж

0 - нерекуррентный платеж

0

Признак рекуррентного/первоначального платежа

...

MIT COF.

Note

Не допускается одновременная передача с параметром CustomerNumber.

RecurringMinAmountДаЧисло, 15 знаков, два знака после разделителя (допустимые разделители «.», «,»)

Минимальная сумма повторных платежей.

Note

Не допускается одновременная передача с параметром CustomerNumber.

RecurringMaxAmountДаЧисло, 15 знаков, два знака после разделителя (допустимые разделители «.», «,»)

Максимальная сумма повторных платежей.

Note

Не допускается одновременная передача с параметром CustomerNumber.

RecurringCountДаЧисло, 3 цифры

Максимальное количество повторных списаний (до 999)

Note

Не допускается одновременная передача с параметром CustomerNumber.

RecurringMaxDateДаСтроковое представление даты в формате DD.MM.YYYY

Дата окончания подписки.

Note

Не допускается одновременная передача с параметром CustomerNumber.

Для этого должны быть переданы обязательные дополнительные параметры, определяющие суммы и интервалы для выполнения последующих платежей
Note

Платеж будет проведен как операция MIT COF только в том случае, если для магазина в АПК Ассист настроен соответствующий процессинг. В противном случае операция будет проведена как обычный рекуррентный платеж

Warning

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

Дополнительные веб-сервисы для COF

...

Веб-сервис позволяет предприятию получать список токенов карт по уникальному идентификатору своего клиента.

Для обращения к веб-сервису необходимо отправить запрос методом POST на сервер ASSIST по адресу: https://<SERVER_NAME>/pay/oneclick/v1/token.cfm с параметрами в формате JSON.

...

Название

Значение

token

Токен сохраненного платежного средства

post

4 последние цифры номера карты

bin

6 первых цифр номера карты

brand

Платежная система карты

bank

Названия банка эмитента карты

expire

Месяц и год окончания действия карты (MM.YYYY)

active

Действительна ли карта

needCVC

Требуется ли вводить CVC для авторизации

assets*

Массив медиаданных для карты (определяют внешний вид карты)

*Если АПК Ассист не располагает медиаданными для карты, то в ответе этот параметр возвращается с пустым значением.

Содержание массива медиаданных

Параметр

Принимаемые значения

Описание

assetType

BRAND_LOGO
ISSUER_LOGO
CO_BRAND_LOGO
CARD_BACKGROUND_COMBINED
CARD_BACKGROUND
ICON
TERMS_AND_CONDITIONS

Тип графического компонента дизайна карты

altText



paymentType

VISA
MC

Тип платежной системы

assetData

url


Адрес файла, содержащего изображение графического компонента дизайна карты

mediaType

image/png
image/pdf (VISA)
application/pdf (MC)
text/plain
text/html

Формат файла изображения

width


Размеры изображения в пикселях

height


В случае ошибки сервис возвращает данные об ошибке в формате JSON {"fault":{"detail":"<текст ошибки>","faultcode":<первый код>,"faultstring":<второй код>}}.

...

Code Block
languagexml
[{"expire":"12.20202025","token":"B092E5A149D902C6-57BD1CCF-46E64605-F3809228-7D5EC773057811D0E8115C77","bank":"CJSC ALFA-BANK","brand":"VISA","bin":462710412362,"active":true,"needCVC":false,"post":"0028","assets":[{"assetType":"ICON","altText":"cardSymbol","paymentType":"VISA","assetData":[
{"url":"https://emvts-test-assets.s3.amazonaws.com/A5/VISA/aa3dcd69e8e8407fa2a59a1956994610/w100_h100.png","mediaType":"image/png","width":100,"height":100}
]},{"assetType":"CARD_BACKGROUND","altText":"digitalCardArt","paymentType":"VISA","assetData":[
{"url":"https://emvts-prod-assets.s3.eu-north-1.amazonaws.com/B5/VISA/fa0ff42cfa9e41b09ae8c2899d61394a/w1536_h969.png","mediaType":"image/png","width":1536,"height":969}
]}]},{"expire":"12.2025","token":"4D7F0B0D-B701-47B0-779A-BB0CB5F25A14","bank":"","brand":"MasterCard","bin":518615,"active":true,"needCVC":false,"post":"1030","assets":[{"assetType":"BRAND_LOGO","altText":null,"paymentType":"MC","assetData":[
{"url":"https://emvts-test-assets.s3.amazonaws.com/A5/MC/3789637f-32a1-4810-a138-4bf34501c509/w0_h0.pdf","mediaType":"image/pdf","width":null,"height":null}
]},{"assetType":"ICON","altText":null,"paymentType":"MC","assetData":[
{"url":"https://emvts-prod-assets.s3.eu-north-1.amazonaws.com/B5/MC/a7556277-51e9-4ef1-b503-dd8989e7a8bf/w100_h100.png","mediaType":"image/png","width":100,"height":100}
]},{"assetType":"CARD_BACKGROUND_COMBINED","altText":null,"paymentType":"MC","assetData":[
{"url":"https://emvts-prod-assets.s3.eu-north-1.amazonaws.com/B5/MC/eb50276e-7e28-4cd1-9b95-c8dfbe595db6/w1536_h969.png","mediaType":"image/png","width":1536,"height":969}
]},{"assetType":"ISSUER_LOGO","altText":null,"paymentType":"MC","assetData":[
{"url":"https://emvts-prod-assets.s3.eu-north-1.amazonaws.com/B5/MC/de7ce012-641e-450c-8b4f-a65d78062999/w1372_h283.png","mediaType":"image/png","width":1372,"height":283}
]}]}]

Пример ответа для случая, когда для карты отсутствуют медиаданные:

Code Block
languagexml
[":"4724"},{"expire":"12.20202025","token":"0DA65AF191720736-F43ECF93-486C469C-078263A0-0C07EC9ED42DE5859815D6BA","bank":"Bank Hong KongUSA","brand":"MasterCard","bin":552926546792,"active":true,"needCVC":truefalse,"post":"4128","6119assets":[]}]


Удаление сохраненной карты (токена) клиента предприятия

...