Page History
...
- финансовой транзакцией – с верификацией карты и последующей оплатой;
- регистрационной транзакцией – с верификацией карты без последующей оплаты.
Первичная операция может быть проведена как с использованием обычной банковской карты, так и с использованием системы токенизации мобильных устройств, например, Apple Pay или Samsung Pay. В любом случае, верификация Первичная операция COF проводится с верификацией одним из возможных способов (CVC2 и 3dS 3DS или с помощью мобильного устройства) обязательна для первичной операции COF.
Повторные операции могут осуществляться после успешного проведения первичной операции с обязательным согласием плательщика на дальнейшее использование данных карты. Повторные операции проводятся без процедуры повторной верификации, если это позволяет протокол работы процессинга. Повторная верификация может быть включена по требованию процессинга или мерчанта, желающего защитить также и повторные транзакции.
Note |
---|
Примечание. Если оплата проводится с использованием системы токенизации мобильных устройств (Apple Pay или Samsung Pay), то повторные операции будут аналогичны первичным, без дополнительных особенностей. |
Операции CIT COF
Повторные операции могут быть инициированы плательщиком. Такие операции называются Customer Initialized Transaction (CIT).
...
Сервис One Click дает возможность постоянному клиенту предприятия совершать новые покупки без ввода данных карты, подтверждая оплату только указанием кода CVC2. Однако, при успешном проведении первичной операции COF, при последующих операциях CVC2 запрашиваться не будетдля последующих покупок по сохраненной карте CVC2 обычно запрашиваться не будет (за исключением тех случаев, когда делаются специальные настройки по желанию мерчанта).
Note |
---|
Для подключения предприятию возможности выполнения операций COF следует отправить соответствующую заявку в клиентский отдел по адресу support@belassist.by. В заявке должен присутствовать идентификатор предприятия (мерчанта) в системе – MerchantID. |
...
Название | Обязательное поле | Принимаемые значения | По умолчанию | Описание |
RecurringIndicator | Да | 1 – рекуррентный платеж 0 - нерекуррентный платеж | 0 | Признак рекуррентного/первоначального платежа MIT COF. |
RecurringMinAmount | Да | Число, 15 цифр ( знаков, два знака после разделителя (допустимый разделитель «.») | Минимальная сумма повторных платежей. | |
RecurringMaxAmount | Да | Число, 15 цифр ( знаков, два знака после разделителя (допустимый разделитель «.») | Максимальная сумма повторных платежей. | |
RecurringCount | Да | Число, 3 цифры | Максимальное количество повторных списаний (до 999) | |
RecurringMaxDate | Да | Строковое представление даты в формате DD.MM.YYYY | Дата окончания подписки. |
...
Предприятие может инициировать последующие платежи через запрос к веб-сервису системы АПК Ассист (описание параметров инициирующего авторизационного запроса и веб-сервиса для последующих платежей см. в соответствующем разделе).
Дополнительные веб-сервисы для COF
Получение списка токенов карт клиента
Веб-сервис позволяет предприятию получать список токенов карт по уникальному идентификатору своего клиента.
Для обращения к веб-сервису необходимо отправить запрос методом POST на сервер ASSIST по адресу: https://<SERVER_NAME>/pay/oneclick/v1/token.cfm с параметрами в формате JSON.
Входные параметры сервиса:
Параметр | Обязательный | Принимаемые значения | Значение по умолчанию | Описание | |
Merchant | Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |
Login | Да | 20 символов | Логин пользователя сервиса от предприятия | ||
Password | Да | 30 символов | Пароль пользователя сервиса от предприятия | ||
CustomerNumber* | Да | 32 символа | Внутренний номер клиента предприятия (мерчанта) | ||
Language | Нет | RU - русский, EN - английский | Язык юр.лица или предприятия | Язык авторизационных страниц |
*Следует обратить внимание на то, что параметр подвергается валидации согласно правилам,
Пример запроса:
Code Block | ||
---|---|---|
| ||
POST https://<SERVER-NAME>/pay/oneclick/v1/token.cfm
POST data:{"merchant":{"merchant_id":"452739", "login":"LOGIN", "password":"PASSWORD"}, "customernumber":"1234", "language":"RU"} |
Ответ также передается в формате JSON и содержит следующие параметры.
Перечень возвращаемых параметров:
Название | Значение |
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.2025","token":"49D902C6-1CCF-4605-9228-11D0E8115C77","bank":"","brand":"VISA","bin":412362,"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 | ||
---|---|---|
| ||
[{"expire":"12.2025","token":"91720736-CF93-469C-63A0-E5859815D6BA","bank":"Bank USA","brand":"MasterCard","bin":546792,"active":true,"needCVC":false,"post":"4128","assets":[]}] |
Удаление сохраненной карты (токена) клиента предприятия
Веб-сервис позволяет предприятию удалить токен карты по уникальному идентификатору своего клиента.
Для обращения к веб сервису необходимо отправить запрос методом POST на сервер ASSIST по адресу: https://<SERVER_NAME>/pay/oneclick/v1/rem_token.cfm с параметрами в формате JSON.
Входные параметры сервиса:
Параметр | Обязательный | Принимаемые значения | Значение по умолчанию | Описание | |
Merchant | Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |
Login | Да | 20 символов | Логин пользователя сервиса от предприятия | ||
Password | Да | 30 символов | Пароль пользователя сервиса от предприятия | ||
CustomerNumber* | Да | 32 символа | Внутренний номер клиента предприятия (мерчанта) | ||
Language | Нет | RU - русский, EN - английский | Язык юр.лица или предприятия | Язык авторизационных страниц | |
Token | Да | 36 символов | Токен сохраненного платежного средства |
*Следует обратить внимание на то, что параметр подвергается валидации согласно правилам.
Пример запроса:
Code Block | ||
---|---|---|
| ||
POST https://<SERVER-NAME>/pay/oneclick/v1/rem_token.cfm
POST data:{"merchant":{"merchant_id":"452739","login":"LOGIN", "password":"PASSWORD"}, "token": "54F5A3DE-4B47-4B40-03B5-7FF992D6B401", "language": "RU", "customernumber":"1234"} |
Ответ также передается в формате JSON с сообщением о том, что токен удален.
Пример ответа:
Code Block | ||
---|---|---|
| ||
{"message":"Token 33479991-B4E5-40FE-D9ED-EDC94BA7FA14 is removed"} |
В случае ошибки сервис возвращает данные об ошибке в формате JSON {"fault":{"detail":"<текст ошибки>","faultcode":<первый код>,"faultstring":<второй код>}}.