3.6. Операции с третьесторонними кошельками

На этой странице приведено описание операций с третьесторонними кошельками cистемы диспетчеризации Procard.Pay

К операциям с третьесторонними кошельками относятся:

  • PURCHASEMASTERPASS – операция покупки с использованием токена MasterPass

  • GOOGLEPAYPURCHASE – операция покупки с использованием токена Google Pay

  • APPLEPAYPURCHASE– операция покупки с использованием токена Apple Pay

  • APH2HPURCHASE– операция покупки с использованием токена Apple Pay на странице

Операции с MasterPass

Получение токена для MasterPass

Production url: https://pay.procard.ua/api/mptoken

Для получения гостевого токена необходимо отправить POST запрос со следующими данными:


На этой странице:

Параметр

Описание

Параметр

Описание

msisdn

Номер телефона для входа в кошелек Masterpass в формате 380XXXXXXXXX

client_id

Идентификатор клиента в системе MasterPass

В ответ приходит объект в формате JSON со следующими параметрами:

Параметр

Описание

Параметр

Описание

res

Результат запроса 0 - все ок

msg

Сообщение об ошибке

token

Токен для передачи в mfs библиотеку

reference_no

Уникальный номер запроса

 Операция PURCHASEMASTERPASS – проведение платежа через MasterPass

Production url: https://pay.procard.ua/api

Для получения гостевого токена необходимо отправить POST запрос со следующими данными:

Параметр

Описание

Значение

Параметр

Описание

Значение

operation

Тип операции

PURCHASEMASTERPASS

merchant_id

Идентификатор торговца

 

amount

Сумма платежа в формате 1.00

Пример 500.00

order_id

 

 

currency_iso

Валюта

UAH

description

Описание платежа

 

approve_url

URL для переадресации после успешного платежа (в случае подтверждения 3DS на странице Procard.PAY)

 

decline_url

URL для переадресации после не успешного платежа (в случае подтверждения 3DS на странице Procard.PAY)

 

cancel_url

URL для переадресации после отмены платежа (в случае подтверждения 3DS на странице Procard.PAY)

 

callback_url

URL на который будет отправлен CALLBACK о статусе платежа

 

add_params[wallet]

Признак кошелька

masterpass

add_params[msisdn]

Номер телефона для входа в кошелек Masterpass в формате 380XXXXXXXXX

 

add_params[token]

Токен полученный с сервера MasterPass

 

add_params[card_name]

Alias карты полученный с сервера MasterPass

 

add_params[client_id]

Идентификатор мерчанта в системе MasterPass

 

add_params[ret_ref_no]

Уникальный номер транзакции полученный с сервера MasterPass

 

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца.

 

 

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, currency_iso, description разделенных “;” (точка с запятой) в кодировке UTF-8.

 

 

Порядок параметров при конкатенации важен!

 

В ответ приходит объект в формате JSON со следующими параметрами:

Параметр

Описание

Параметр

Описание

code

Код ответа

status

Статус транзакции, если необходима проверка 3DS , в статусе , будет значение 3ds

d3AcsUrl

url для перенаправления клиента, для проверки 3ds

d3Md

Криптограмма для передачи на хост 3DS

d3Pareq

Запрос для передачи на хост 3DS

transaction_key

Ключ транзакции для подтверждения 3DS

TermUrl

Url для переадресации после ввода кода подтверждения на странице 3DS. По умолчанию url на страницу Procard.PAY, для проверки 3DS можно указать свой URL, тогда после прохождения 3DS необходимо вызвать метод “Подтверждение 3DS верификации”

signature

 

Операции с Google Pay

Платежный метод GOOGLEPAYPURCHASE

Production URL: https://pay.procard.ua/api 

Для списания средств с карты необходимо переадресовать пользователя на страницу платежного шлюза методом POST со следующими параметрами:

Параметр

Описание

Значение

Параметр

Описание

Значение

operation

Тип операции

GOOGLEPAYPURCHASE

merchant_id

Идентификатор мерчанта

 

amount

Сумма платежа в формате 1.00

Пример 500.00

order_id

Уникальный номер операции на стороне торговца. Если операция дублируется - торговец получает ошибку.

 

currency_iso

Валюта платежа

UAH

description

Описание платежа

 

callback_url

URL на который придет информация о результате выполнения платежа

 

gpApiVersionMinor

apiVersionMinor из processPayment(paymentData)

 

gpApiVersion

apiVersion из processPayment(paymentData)

 

gpPMDescription

paymentMethodData.description из processPayment(paymentData)

 

gpPMType

paymentMethodData.type из processPayment(paymentData)

 

gpPMICardNetwork

paymentMethodData.info.cardNetwork из processPayment(paymentData)

 

gpPMICardDetails

paymentMethodData.info. cardDetails из processPayment(paymentData)

 

gpTokenType

paymentMethodData.tokenizationData.type из processPayment(paymentData)

 

gpToken

aymentMethodData.tokenizationData.token из processPayment(paymentData)

 

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца.

 

 

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, currency_iso, description разделенных “;” (точка с запятой) в кодировке UTF-8.

 

 

Порядок параметров при конкатенации важен!

 

В ответ приходит объект в формате JSON со следующими параметрами:

Параметр

Описание

Значение

Параметр

Описание

Значение

code

Код ответа

Справочник “Статусы платежа”

status

Статус платежа. Если в статусе платежа прийдет 3DS - необходимо выполнить проверку 3DS

Справочник “Коды ответов”

d3AcsUrl

acs url для проверки 3DS

 

d3Md

Уникальный идентификатор для передачи на хост 3DS

 

d3Pareq

PaReq сообщение для передачи на хост 3DS

 

transaction_key

Ключ транзакции для подтверждения 3DS

 

signature

 

 

Операции с Apple Pay

Операция покупки с Apple Pay

Для интеграции кнопки Apple Pay на платежную страницу интернет магазина необходимо реализовать метод ApplePaySession.canMakePaymentsWithActiveCard, этот метод определяет поддерживает ли данное устройство оплату с помощью Apple Pay.

Если поддерживается оплата - необходимо отрисовать кнопку “Купить с помощью Apple Pay”.

Далее необходимо создать объект ApplePaySession с параметрами покупки:

1 2 3 4 5   countryCode: 'UA',   currencyCode: 'UAH',   supportedNetworks: ['visa', 'masterCard'],   merchantCapabilities: ['supports3DS'],   total: { label: 'Your Merchant Name', amount: '10.00' },

Описание полей приведено в документации Apple Pay on Web.

На событие onvalidatemerchant необходимо повесить обработчик, в котором будет вызываться API “api/apple/validate”

На событие onpaymentauthorized необходимо повесить обработчик, который будет вызывать API “api/apple/payment”.

После подтверждения платежа в onpaymentauthorized необходимо вызвать метод ApplePaySession.completePayment.

Документация по ApplePaySession находится на оф сайте Apple (https://developer.apple.com/documentation/apple_pay_on_the_web/apple_pay_js_api ).

Валидация мерчанта Apple Pay (api/apple/validate)

Production url: https://pay.procard.ua/api/apple/validate

POST параметры:

Параметр

Описание

Значение

Параметр

Описание

Значение

operation

Тип операции

APPLEPAYPURCHASE

apple_validation_url

Данный параметр приходит в событии onvalidatemerchant, event.validationURL

 

 

Пример:

session.onvalidatemerchant = (event) => {

console.log(event.validationURL);

}

 

merchant_id

ID мерчанта, выдается поцесcингом

 

amount

Сумма операции.

Пример 500.00

order_id

Уникальный номер операции на стороне торговца. Если операция дублируется - торговец получает ошибку.

 

currency_iso

Валюта платежа.

UAH

description

Назначение платежа. Выводится на платежной странице, при вводе платежных реквизитов. Отображается в выписке по счету и реестрах

 

add_params

Массив с дополнительными параметрами. Дополнительные параметры потом возвращаются мерчанту в callback вызове

 

callback_url

URL на который придет информация о результате выполнения платежа

 

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512контрольная подпись с использованием private_key торговца.

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, currency_iso, description разделенных “;” (точка с запятой) в кодировке UTF-8.

 

 

Порядок параметров при конкатенации важен!

 

В ответ приходит объект в формате JSON со следующими параметрами:

Параметр

Описание

Параметр

Описание

apple_validate_data

Данные которые необходимо передать в метод session.completeMerchantValidation

order_key

Идентификатор заказа в платежной системе

code

Код ответа если 0 - все ок

message

Расшифровка кода ответа

signature

 

Подтверждение платежа Apple Pay (api/apple/payment)

Production url: https://pay.concord.ua/api/apple/payment

POST параметры:

Параметр

Описание

Параметр

Описание

order_key

Идентификатор заказа в платежной системе

apple_pay_payment_data

Данные закодированные в base64, полученные в newсобытии onpaymentauthorized в параметре event.payment.

 

Пример:

session.onpaymentauthorized = (event) => {
console.log(event.payment);
}

В ответ приходит объект в формате JSON со следующими параметрами:

Параметр

Описание

Параметр

Описание

transactionStatus

Статус операции
Approved - Успешно / Declined - Отказ

reason

Текстовая причина отказа

reasonCode

Код ошибки при отказе

После вызова этого метода приходит CALLBACK в backend торговца.

ApplePay Host2Host (api/apple/h2hpayment)

Production url:   https://pay.concord.ua/api/apple/h2hpayment

Для подключения H2H ApplePay необходимо сгенерировать сертификат мерчанта в кабинете разработчика Apple и отправить сгенерированный сертификат на почту paysupport@procard-ltd.com

POST параметры:

Параметр

Описание

Значение

Параметр

Описание

Значение

operation

Тип операции

APH2HPURCHASE

merchant_id

ID мерчанта, выдается платежным шлюзом

 

amount

Сумма операции. Пример 500.00

 

customer_fee

Комиссия с клиента. Пример: 10.50

 

order_id

Уникальный номер операции на стороне торговца. Если операция дублируется - торговец получает ошибку.

 

currency_iso

Валюта платежа.  UAH, USD, EUR

 

description

Назначение платежа. Выводится на платежной странице, при вводе платежных реквизитов. Отображается в выписке по счету и реестрах

 

add_params

Массив с дополнительными параметрами. Дополнительные параметры потом возвращаются мерчанту в callback вызове

 

apple_payment_data

Данные токена полученные от Apple закодированные в base64, полученные

 

card_holder

Владелец карты.

 

phone

Номер телефона клиента.

 

payment_type

Тип платежа.

Purchase - покупка

PreAuth - блокирование средств на карте

 

callback_url

URL на который придёт информация о результате выполнения платежа

 

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца.

 

 

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, currency_iso, description разделенных “;” (точка с запятой) в кодировке UTF-8.

 

 

Порядок параметров при конкатенации важен!

 

В ответ приходит объект в формате JSON со следующими параметрами:

Параметр

Описание

Значение

Параметр

Описание

Значение

status

Статус платежа

Справочник “Статусы платежа”

code

Код ответа

Справочник “Коды ответов”

order_id

Уникальный номер заказа в системе торговца

 

amount

Сумма платежа

 

fee

Комиссия

 

currency

Валюта платежа

 

transaction_id

Идентификатор транзакции

 

signature

 

 

  


Copyright © 2015-2021 PROCARD