Приложение 6. Использование кошельков ApplePay
На этой странице описан принцип использования кошельков ApplePay на портале ПЦ "Прокард" с использованием продукта PC-ECOM-PG
Использование кошельков ApplePay для оплаты на страницах сервис провайдеров возможно после интеграции сервис провайдера с платежной системой ApplePay (https://developer.apple.com/apple‑pay/).
Для выполнения операции необходимо получить данные токена от системы ApplePay согласно их протоколу взаимодействия.
Для формирования транзакции ApplePay согласно требований МПС, необходимо заполнить поля протокола специальным образом:
Cоздание заказа
При создании заказа (административная операция CreateOrder) необходимо добавить «дополнительные параметры» блока order:
Для МПС MasterCard:
AddParams->MasterPassWalletId = 103
AddParams->DSRPFlag = 1.
Пример XML-запроса административной операции CreateOrder с доппараметрами для МПС MasterCard:
<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
<Request>
<Operation>CreateOrder</Operation>
<Language>RU</Language>
<Order>
<OrderType>Purchase</OrderType>
<Merchant>TEST_TRADER</Merchant>
<Amount>5000</Amount>
<Currency>980</Currency>
<Description>Тестовая покупка</Description>
<AddParams>
<MasterPassWalletId>103</MasterPassWalletId> <DSRPFlag>1</DSRPFlag> </AddParams> </Order> </Request>
</TKKPG>
Для МПС Visa:
AddParams->MasterPassWalletId = 103
Пример XML-запроса административной операции CreateOrder с доппараметрами для МПС Visa:
<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
<Request>
<Operation>CreateOrder</Operation>
<Language>RU</Language>
<Order>
<OrderType>Purchase</OrderType>
<Merchant>TEST_TRADER</Merchant>
<Amount>5000</Amount>
<Currency>980</Currency>
<Description>Тестовая покупка</Description>
<AddParams>
<MasterPassWalletId>103</MasterPassWalletId>
</AddParams>
</Order>
</Request>
</TKKPG>
Операции ProcessPARes или Purchase
При выполнении административных операций ProcessPARes или Purchase заполнить параметры, полученные из сообщения ApplePay, следующим образом:
applicationPrimaryAccountNumber => PAN
applicationExpirationDate => ExpDate – преобразованный из формата YYMMDD в формат YYMM
CVV2 = -1
ECI = 82
Так же при использовании токена ApplePay необходимо использование поля CAVV, но преобразованного нестандартным способом.
ApplePay возвращает значение cavv в поле onlinePaymentCryptogram, но значения xid не возвращает.
Необходимо сгенерировать значение xid: 20 символов преобразованных в Base64.
Пример формирования xid:
$xid = base64_encode((time()-3600)."0000000000");
Для МПС MasterCard механизм формирования поля CAVV не меняется, но для МПС Виза необходимо конвертировать значения xid и cavv в формат hexadecimal.
При использовании примера вычисления CAVV из Приложения 4, то, при операции ApplePay, необходимо использовать другой механизм преобразования CAVV:
меняется на
Другие параметры запросов необходимо заполнять как обычно, согласно описанных в данном документе требований.
При использовании технологии 3DSecure и Токена ApplePay одновременно - необходимо передать значение TAVV и CAVV (после проверки 3DS) и eci=82.
В этом случае значение CAVV (после проверки 3DS) необходимо передавать в поле CAVV преобразованное стандартным способом, а поле TAVV необходимо передавать в поле
AddParams->TokenCryptogram преобразованное согласно правил описанных выше.
Если операция не 3DSecure, тогда в финансовой операции передается значение eci=87 и CAVV.
Пример XML-запроса административной операции Purchase для транзакции ApplePay:
Copyright © 2015-2021 PROCARD