Acceptarea plăților prin QR MIA

Pentru a începe integrarea, este necesar să contactați Bpay și să obțineți:

• Identificatorul unic al comerciantului merchantId
• Cheia secretă secretKey pentru semnarea mesajelor

Între timp, unele lucrări pot fi efectuate înainte de a primi aceste date (vezi secțiunea Testare)

Fiecare mesaj al comerciantului trebuie să fie semnat. Pentru a genera semnătura, este necesar să utilizați cheia secretă (secretKey) emisă de Bpay la înregistrarea comerciantului, pentru a calcula hash-ul SHA256 al unui șir format din anumiți parametri. În descrierea fiecărei metode API vor fi enumerați parametrii din care se va forma semnătura. De exemplu, {dateTime}{merchantId}{amount}{description} va însemna că pentru a forma semnătura, trebuie să concatenați valorile celor patru parametri: dateTime, merchantId, amount, description și să aplicați hashing-ul SHA256 cu cheia secretă.

Semnătura obținută este transmisă în antetul X-HMAC-Signature al cererii http corespunzătoare.

Mai jos este prezentat codul în mai multe limbi de programare pentru această operațiune

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();
}
                

Producție: https://qr-merchant.bpay.md

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

În cazul nostru, va fi generat un cod QR dinamic cu o sumă fixă de plată. Pentru aceasta, trebuie să trimiteți datele de plată către Bpay printr-o cerere GET GET /api/Qr/CreateMerchantQr

Parametrii cererii:

Anteturi ale cererii:

Exemplu de răspuns de succes

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

Pentru a genera un QR hibrid, trebuie mai întâi să generați antetul acestuia, apoi să generați extensia asociată cu acest antet

Parametrii cererii:

Anteturi ale cererii:

Informații despre chei în răspuns

Exemplu de răspuns de succes

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

Exemplu de răspuns nereușit

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

Verificarea plății poate fi realizată nu doar prin apeluri periodice ale metodei de verificare a plății, ci și prin utilizarea callback, adică în momentul acceptării plății în adresa comerciantului Bpay va apela o metodă API furnizată de comerciant.

În cazul în care este necesară utilizarea callback, trebuie să trimiteți o cerere corespunzătoare la ecomm@bpay.md

Parametrii cererii:

Anteturi ale cererii:

Parametrii cererii:

Anteturi ale cererii: