Приём платежей посредством QR MIA

Для начала работ по интеграции необходимо обратиться в Bpay и получить:

• Уникальный идентификатор мерчанта merchantId
• Секретный ключ secretKey для подписания сообщений

При этом некоторые работы можно произвести до получения этих данных (см. раздел Тестирование)

Каждое сообщение мерчанта должно быть подписано. Для генерации подписи необходимо при помощи секретного ключа (secretKey), выданного Bpay при регистрации мерчанта, вычислить SHA256 hash от строки, сформированной из некоторых параметров параметров. В описании каждого метода API будут перечислены параметры, из которых будет формироваться подпись. Например, {dateTime}{merchantId}{amount}{description} — будет значить, что для формирования подписи надо контантенировать значения четырех парамертов: dateTime, merchantId, amount, description и к ним применить SHA256 хэширование секретным ключом.

Полученная подпись передается в заголовке X-HMAC-Signature соотвествующего http запроса.

Ниже представлен код на нескольких языках программирования для этой операции

function calculateHMAC($key, $message) {
    $hash = hash_hmac('sha256', $message, $key, true);
    return strtolower(base64_encode($hash));
}
                    

function calculateHMAC(key, message) {
    var key = CryptoJS.enc.Utf8.parse(key);
    var message = CryptoJS.enc.Utf8.parse(message);
    var hash = CryptoJS.HmacSHA256(message, key);
    var hashInBase64 = CryptoJS.enc.Base64.stringify(hash).toLowerCase();
    return hashInBase64;
}
                    

public string CalculateHMAC(string key, string message) {
    var keyByte = Encoding.UTF8.GetBytes(key);
    using var hmacsha256 = new HMACSHA256(keyByte);
    var hashmessage = hmacsha256.ComputeHash(Encoding.UTF8.GetBytes(message));
    return Convert.ToBase64String(hashmessage).ToLower();
}
                    

Production: https://qr-merchant.bpay.md

Test: https://qr-test.bpay.md

В нашем случае будет формироваться динамический QR-код с фиксированной суммой оплаты. Для этого необходимо отправить в Bpay данные по оплате GET запросом GET /api/Qr/CreateMerchantQr

Параметры запроса:

Заголовки запроса:

Пример успешного ответа

{
"qrHeaderUUID": "f56212dd-7b6e-47a3-95f6-fb900aafc555",
"qrExtensionUUID": "7c39841f-09e8-46da-bd23-6833bc218b7e",
"qrAsText": "https://mia-qr.bnm.md/1/m/BNM/BNMf56212dd7b6e47a395f6fb900aafc555"
}
             

Для того чтобы сформировать гибридный QR надо сначала сгенерировать его заголовок, затем сгенерировать расширение, привязанное к этому заголовку

Параметры запроса:

Заголовки запроса:

Информация о ключах в ответе

Пример успешного ответа

{
"isPaid":true,
"paymentDetails":{
    "receipt":"105468532550586",
    "state":100,
    "provAmount":10.0000
}
}
             

Пример неудачного ответа

{
"isPaid": false,
"paymentDetails": null
}
             

Проверка оплаты может осуществляться не только периодическим вызовом метода проверки оплаты, но и при помощи использования callback, т.е. когда в момент приема платежа в адрес мерчанта Bpay вызовет какой метод API, предоставленного мерчантом.

В случае необходимости использования callback необходимо обратиться с соотвествующим запросом на ecomm@bpay.md

Параметры запроса:

Заголовки запроса:

Параметры запроса:

Заголовки запроса: