Mecanismul de interacțiune descris în această pagină vă va oferi posibilitatea de a emite o factură către utilizator pentru plata cu suma pe care o specificați. Utilizatorul fie va fi redirecționat către pagina de servicii de plată, unde vpoate achita factura într-un mod convenabil, fie veți primi un link (URL) al acestei facturi care o puteți transmite utilizatorului prin e-mail sau să generați un cod QR.

Pentru a iniția o plata printr-o formă de plată unică, trebuie doar să trimiteți utilizatorul la o adresă URL specială, precum și să indicați un șir de parametri obligatorii

Pe site-ul dvs., trebuie să plasați forma care va conține două câmpuri. Câmpul data conține xml sau json (în funcție de formatul pe care îl utilizați) cu informații și câmpul key care va conține semnătura acestor date.

POST

https://pay.bpay.md/merchant

 <form method="POST" action="https://pay.bpay.md/merchant">
 <input type="hidden" name="data" value="">
 <input type="hidden" name="key" value="">
 <input type="submit" value="Submit" >
 </form>
 

Click pe butonul Submit va redirecționa utilizatorul la formularul de plată a sistemultui BPay.md. După efectuarea plății, utilizatorul va fi returnat la pagina site-ului dvs. specificată în success_url. În 15 secunde, serviciul de plată va trimite o notificare cu privire la plata primită în modul specificat de dvs.

Este necesar să formați un array codificaț în JSON care la rîndul să este codificat în base64.

$json = [
 'uuid; => '9fdf75e2-858c-4ed4-98bd-7035168542d0',
 'merchantid' => 'test_merchant',
 'amount' => 10,
 'order_id' => 9876,
 'description' => 'Integration request',
 'lang' => 'ru',
 'method' => 'bpay',
 'success_url' => 'https://bpay.md/success',
 'fail_url' => 'https://bpay.md/fail',
 'callback_url' => 'https://bpay.md/callback',
 'valute' => 498,
 'dtime' => date('Y-m-d H:i:s'),
 'getUrl' => '1',
 'params' => [
 'type_of_payer' => 'main',
 'info' => 'test information',
 'invoice' => [
 [
 'id' => 156,
 'name' => 'mobile phone',
 'model' => 'iphone 8+',
 'sum' => 800
 ],
 [
 'id' => 556,
 'name' => 'TV Philips',
 'model' => 'K223AA2200',
 'sum' => 300
 ]
 ]
 ]
];
$data = base64_encode(json_encode($json));
 

Pentru o securitate suplimentară a plăților dvs., efectuăm verificarea obligatorie a semnăturii digitale la crearea unei plăți. Prezența unei semnături garantează protecția împotriva înlocuirii valorilor transmise (de exemplu, modificarea sumei plății sau a numărului comenzii).

» Formatul: JSON

Semnătura este formată prin combinarea datelor JSON cu semnătura care este emisă în timpul înregistrării magazinului. Apoi, trebuie să generați un hash, utilizînd algoritmul sha256

$signature = 'signature';
$key = hash('sha256', base64_encode(json_encode($json)) . $signature)
 

<?php

$signature="123456"; // подпись, полученная при регистрации мерчанта
 
$json = [
 'uuid' => '9fdf75e2-858c-4ed4-98bd-7035168542d0',
 'merchantid' => 'test_merchant',
 'amount' => 10,
 'order_id' => 9876,
 'description' => 'Payment description',
 'lang' => 'en',
 'success_url' => 'https://bpay.md/success',
 'fail_url' => 'https://bpay.md/success/fail',
 'callback_url' => 'https://bpay.md/success/callback',
 'currency' => 498,
 'dtime' => date('Y-m-d H:i:s'),
 'getUrl' => '1',
 'params' => [
 'type_of_payer' => 'main',
 'info' => 'test information',
 'invoice' => [
 [
 'id' => 156,
 'name' => 'mobile phone',
 'model' => 'iphone 8+',
 'sum' => 800
 ],
 [
 'id' => 556,
 'name' => 'TV Philips',
 'model' => 'K223AA2200',
 'sum' => 300
 ]
 ]
 ]
];

// шифруем данные и подписываем их
$data = base64_encode(json_encode($json));
$key = hash('sha256', $data . $signature);
?>

 <form method="POST" action="https://pay.bpay.md/merchant">
 <input type="hidden" name="data" value="<? echo $data; ?>">
 <input type="hidden" name="key" value="<? echo $sign; ?>">
 <input type="submit" value="Transfer" >
 </form>

Click pe butonul Submit va redirecționa plătitorul la forma de plată a sistemului BPay.md. După plata finisează cu succes, utilizatorul va fi returnat la pagina site-ului dvs. specificată în success_url. În de 15 secunde, comerciantul (magazinul online) va primi o notificare cu privire la plata primită (în modul specificat de dvs.).