Параметр | Описание |
---|---|
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 | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 SHA-512 контрольная подпись с использованием private_key торговца. | |
Строка, подлежащая HMAC_MD5SHA-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 | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 SHA-512 контрольная подпись с использованием private_key торговца. | |
Строка, подлежащая HMAC_MD5SHA-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 с параметрами покупки:
Code Block | ||
---|---|---|
| ||
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 | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная SHA-512контрольная подпись с использованием private_key торговца. Строка, подлежащая HMAC_MD5SHA-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) => { |
В ответ приходит объект в формате JSON со следующими параметрами:
Параметр | Описание |
---|---|
transactionStatus | Статус операции |
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 | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 SHA-512 контрольная подпись с использованием private_key торговца. | |
Строка, подлежащая HMAC_MD5SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, currency_iso, description разделенных “;” (точка с запятой) в кодировке UTF-8. | ||
Порядок параметров при конкатенации важен! |
В ответ приходит объект в формате JSON со следующими параметрами:
Параметр | Описание | Значение |
---|---|---|
status | Статус платежа | Справочник “Статусы платежа” |
code | Код ответа | Справочник “Коды ответов” |
order_id | Уникальный номер заказа в системе торговца | |
amount | Сумма платежа | |
fee | Комиссия | |
currency | Валюта платежа | |
transaction_id | Идентификатор транзакции | |
signature |
Filter by label (Content by label) | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|