Page History
...
Первичная операция может быть проведена как с использованием обычной банковской карты, так и с использованием системы токенизации мобильных устройств, например, Apple Pay, Samsung Pay или Google Pay. В любом случае, верификация Первичная операция COF проводится с верификацией одним из возможных способов (CVC2 и 3D-Secure 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. |
Все действия, связанные с оплатой сохраненной картой, выполняются на стороне АПК Ассист.
...
Рекуррентные платежи используются в том случае, когда требуется периодическое списание средств с банковской карты клиента в счет предприятия – поставщика услуг. Это разного рода подписки – оплата хостинга, мобильного телефона, доступа к ресурсам и т. п. Метод удобен для пользователя, так как данные карты вводятся клиентом только один раз при первом платеже.Предприятие может хранить расписание подписки на своей стороне и инициировать последующие платежи через запрос к веб-сервису системы АПК Ассист (описание параметров инициирующего авторизационного запроса и веб-сервиса для последующих платежей см. в соответствующем разделе).
В отличие от рекуррентных платежей, суммы платежей MIT COF, а также интервалы, через которые они выполняются, не фиксируются. Таким образом, предприятие может инициировать платеж на необходимую сумму в любой момент времени (например, в случае обнуления баланса какой-либо услуги).
Для реализации последующих первоначальных платежей MIT COF необходимо передать дополнительные параметры:
Название | Обязательное поле | Принимаемые значения | По умолчанию | Описание | ||
RecurringIndicator | Да | 1 – рекуррентный платеж 0 - нерекуррентный платеж | 0 | Признак рекуррентного/первоначального платежа MIT COF.
| ||
RecurringMinAmount | Да | Число, 15 |
знаков, два знака после разделителя (допустимые разделители «.», «,») | Минимальная сумма |
...
повторных платежей.
| ||||||
RecurringMaxAmount | Да | Число, 15 знаков, два знака после разделителя (допустимые разделители «.», «,») | Максимальная сумма повторных платежей.
| |||
RecurringCount | Да | Число, 3 цифры | Максимальное количество повторных списаний (до 999)
| |||
RecurringMaxDate | Да | Строковое представление даты в формате DD.MM.YYYY | Дата окончания подписки.
|
Note | |
---|---|
Платеж будет проведен как операция MIT COF только в том случае, если для магазина в АПК Ассист настроен соответствующий процессинг. В противном случае операция будет проведена как обычный рекуррентный платеж Warning | |
Предприятие может инициировать последующие платежи через запрос к веб-сервису системы АПК Ассист (описание параметров инициирующего авторизационного запроса и веб-сервиса для последующих платежей см. в соответствующем разделе).
Дополнительные веб-сервисы для COF
...
Название | Значение |
token | Токен сохраненного платежного средства |
post | 4 последние цифры номера карты |
bin | 6 первых цифр номера карты |
brand | Платежная система карты |
bank | Названия банка эмитента карты |
expire | Месяц и год окончания действия карты (MM.YYYY) |
active | Действительна ли карта |
needCVC | Требуется ли вводить CVC для авторизации |
assets* | Массив медиаданных для карты (определяют внешний вид карты) |
*Если АПК Ассист не располагает медиаданными для карты, то в ответе этот параметр возвращается с пустым значением.
Содержание массива медиаданных
Параметр | Принимаемые значения | Описание |
assetType | BRAND_LOGO | Тип графического компонента дизайна карты |
altText | ||
paymentType | VISA | Тип платежной системы |
assetData | ||
url | Адрес файла, содержащего изображение графического компонента дизайна карты | |
mediaType | image/png | Формат файла изображения |
width | Размеры изображения в пикселях | |
height |
В случае ошибки сервис возвращает данные об ошибке в формате JSON {"fault":{"detail":"<текст ошибки>","faultcode":<первый код>,"faultstring":<второй код>}}.
...
Code Block | ||
---|---|---|
| ||
[{"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 | ||
---|---|---|
| ||
[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":[]}] |
Удаление сохраненной карты (токена) клиента предприятия
...