Acceptarea Plăților prin QR MIA

Pentru a începe lucrările de integrare, trebuie să contactați Bpay și să obțineți:

• Un identificator unic al comerciantului merchantId
• O cheie secretă secretKey pentru semnarea mesajelor

Unele lucrări pot fi efectuate înainte de a primi aceste date (vezi secțiunea Testare)

În QR se codifică un link de următorul format: “https://mia-qr.bnm.md/1/m/BNM/BNM6bb781617b6a417fac071c4cf316b0c4“,
unde identificatorul unic al codului QR este evidențiat cu caractere aldine

Pentru a obține un astfel de link pentru plată, trebuie să trimiteți un request GET corespunzător către Bpay GET https://qr-test.bpay.md/api/Qr/CreateMerchantQr

Parametrii Request-ului:

Header-uri Request-ului:

Formarea X-HMAC-Signature

Pentru a genera semnătura, utilizați cheia secretă (secretKey) furnizată de Bpay la înregistrarea comerciantului pentru a calcula hash-ul SHA256 al șirului format din parametrii request-ului. Acest șir este format prin concatenarea tuturor parametrilor request-ului (cu excepția getPaid) în ordinea în care sunt enumerați mai sus, adică: {dateTime}{merchantId}{amount}{description}.
Aplicați hash-ul HMAC (Hash-based Message Authentication Code) șirului rezultat, utilizând SecretKey ca cheie HMAC. Rezultatul trebuie prezentat ca un șir Base64.

Exemplu Java:

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

Exemplu C#:

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

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 verifica plata, software-ul comerciantului face un request la următorul link:
GET https://qr.bpay.md/api/Qr/GetQrStatus

Parametrii Request-ului:

Header-uri Request-ului:

Informații despre Cheile din Răspuns

Exemplu de Răspuns de Succes

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

Exemplu de Răspuns Nefericit

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

Dezactivarea Verificării Semnăturii HMAC

• În scopuri de testare, puteți dezactiva verificarea HMAC la generarea QR
• Dacă specificați valorile implicite datetime="2024-04-30T00:00:00", merchantId="qrtest", amount=10, description="descriere test", HMAC nu va fi verificat

Plata QR

• Împreună cu generarea QR, puteți plăti acest QR în scopuri de testare
• Pentru aceasta, când apelați https://qr-test.bpay.md/api/Qr/CreateMerchantQr, trebuie să setați parametrul getPaid la true

Colecția pentru Postman (descărcare):

• Conține request-uri pentru testarea atât a generării QR, cât și a verificării plății
• În variabila colecției SecretKey trebuie să specificați cheia secretă obținută la înregistrarea comerciantului (alte variabile ale colecției nu trebuie schimbate)
• În parametrul request-ului merchantId, înlocuiți identificatorul comerciantului cu cel obținut la înregistrarea comerciantului
• Parametrii request-ului amount și description pot fi schimbați după dorință
• Când trimiteți request-ul, parametrul dateTime va fi generat automat, la fel ca și header-urile X-TraceReference și X-HMAC-Signature. Puteți găsi textul real al request-ului trimis către server în consolă

Instrumente Suplimentare:

• Generarea HMAC în format hex https://emn178.github.io/online-tools/sha256.html
• Conversia hex în base64 https://base64.guru/converter/encode/hex