Спецификация по взаимодействию торговца c ConcordPay

Параметр	Описание	Значение
operation	Тип операции	Purchase
merchant_id	ID мерчанта, выдается поцесcингом
amount	Сумма операции. Пример 500.00
signature	В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца. Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров merchant_id,order_id,amount,currency_iso,description разделенных “;” (точка с запятой) в кодировке UTF-8. Порядок параметров при конкатенации важен!
order_id	Уникальный номер операции на стороне торговца. Если операция дублируется - торговец получает ошибку.
currency_iso	Валюта платежа.	UAH
language	Язык платежной страницы ua,ru,en	ru
description	Назначение платежа. Выводится на платежной странице, при вводе платежных реквизитов. Отображается в выписке по счету и реестрах
add_params	Массив с дополнительными параметрами. Дополнительные параметры потом возвращаются мерчанту в callback вызове
approve_url	URL для переадресации в случае, если платеж успешен
decline_url	URL для переадресации в случае, если платеж не успешен
cancel_url	URL для переадресации в случае, если пользователь отказался совершить оплату
callback_url	URL на который прийдет информация о результате выполнения платежа
redirect	true/false - по умолчанию true, если параметр стоит true, тогда клиент не будет получать переадресацию, а получит url платежной страницы	Не обязательный
auth_type	По умолчанию 1 - покупка, 2-Предавторизация	Не обязательный

Callback вызов для отправки уведомления о статусе платежа

Данные отправляются по URL адресу который указан в параметрах платежа в поле

callback_url.

Данные отправляются на сервер торговца в формате JSON

Параметры:

Название параметра	Описание	Значения
merchantAccount	ID мерчанта
orderReference	ID операции в системе торговца
amount	Сумма операции
currency	Валюта операции
phone	Номер телефона клиента(Если включен ввод телефона на платежной странице)
createdDate	Дата платежа в формате YYYY-MM-DD HH:II:SS Пример: 2018-12-14 12:01:26
cardPan	Маскированный PAN карты. Пример: 535277******0298
cardType	Тип карты	Visa MasterCard
fee	Комиссия за операцию
transactionId	ID транзакции на стороне ПЦ
type	Тип операции. На данный момент параметр не используется
recToken	Токен для рекурентного платежа
transactionStatus	Статус операции	Approved - Успешно Declined - Отказ
pcApprovalCode	Код авторизации
pcTransactionID	Идентификатор транзакции в процессинговом центре
reason	Текстовая причина отказа
reasonCode	Код ошибки при отказе
merchantSignature	В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца. Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров merchant_id,orderReference,amount,currency разделенных “;” (точка с запятой) в кодировке UTF-8. Порядок параметров при конкатенации важен!

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

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

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

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

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.concord.ua/api/apple/validate

POST параметры:

Параметр	Описание	Значение
operation	Тип операции	Purchase
apple_validation_url	Данный параметр приходит в событии onvalidatemerchant, event.validationURL Пример: session.onvalidatemerchant = (event) => { console.log(event.validationURL); }
merchant_id	ID мерчанта, выдается поцесcингом
amount	Сумма операции. Пример 500.00
signature	В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца. Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров merchant_id,order_id,amount,currency_iso,description разделенных “;” (точка с запятой) в кодировке UTF-8. Порядок параметров при конкатенации важен!
order_id	Уникальный номер операции на стороне торговца. Если операция дублируется - торговец получает ошибку.
currency_iso	Валюта платежа.	UAH
description	Назначение платежа. Выводится на платежной странице, при вводе платежных реквизитов. Отображается в выписке по счету и реестрах
add_params	Массив с дополнительными параметрами. Дополнительные параметры потом возвращаются мерчанту в callback вызове
callback_url	URL на который придет информация о результате выполнения платежа

В ответ приходят следующие параметры:

Параметр	Описание
apple_validate_data	Данные которые необходимо передать в метод session.completeMerchantValidation
order_key	Идентификатор заказа в платежной системе
code	Код ответа если 0 - все ок
message	Расшифровка кода ответа

Подтверждение платежа 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);

}

В ответ приходит:

transactionStatus

Статус операции

Approved - Успешно

Declined - Отказ

reason

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

reasonCode

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

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

Рекуррентные платежи RecPayment(оплата по токену)

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

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

Название	Описание
operation	Необходимое значение для данной операции RecPayment
merchant_id	Идентификатор мерчанта
amount	Сумма операции. Пример 500.00
recurring_token	Токен полученный от ПС
order_id	Уникальный номер заказа в системе торговца
description	Назначение платежа
currency_iso	Валюта. На данный момент только UAH
auth_type	1 - покупка, 2 - предавторизация. Не обязательный. По умолчанию - 1
signature	В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца. Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров merchant_id,order_id,amount,recurring_token,currency_iso,description разделенных “;” (точка с запятой) в кодировке UTF-8. Порядок параметров при конкатенации важен!

В ответ приходят следующие параметры:

Название

Параметры

status

APPROVED - успешно,

DECLINED - операция не успешна

code

Код ответа

Операция Verify

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

Имя параметра	Описание	Тип
operation	тип операции “Verify”	String
merchant_id	идентификатор мерчанта	String
order_id	Это уникальный номер операции. Генерируется на стороне мерчанта. Он должен быть уникальным на протяжении всей работы.	Integer
amount	Сумма, которую необходимо закодировать при проверке	Float
currency_iso	Валюта платежа.	UAH
approve_url	URL на который будет перенаправлен пользователь в случае успешной операции	String
decline_url	URL на который будет перенаправлен пользователь в случае не успешной операции	String
cancel_url	URL на который будет перенаправлен пользователь в случае отмены операции	String
signature	В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца. Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров merchant_id,order_id,amount,currency_iso разделенных “;” (точка с запятой) в кодировке UTF-8. Порядок параметров при конкатенации важен!	String

Операция Reversal

Для проверки статуса платежа или верификации карты необходимо отправить POST запрос на url https://pay.concord.ua/api/reversal со следующими параметрами:

Имя параметра	Описание	Тип
merchant_id	идентификатор мерчанта	String
order_id	Это уникальный номер операции которая была отправлена в запросе P2PCredit,P2PDebit или Verify	Integer
amount	Необязательный параметр. Если указана сумма - будет произведен частичный возврат	Float
signature	В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца. Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров $merchant_id,$order_id разделенных “;” (точка с запятой) в кодировке UTF-8. Порядок параметров при конкатенации важен!	String