Acceptarea plăților pe site

Oferim două tipuri de facturare. Factură creată de comerciant și creată de sistema BPay.

În primul caz invoice-ul este creat de către comerciant utilizând API-ul descris mai jos și platforma pay.bpay.md. În al doilea caz invoice-ul este creat de BPay pe site sau terminalul de plată.

Mecanismul de interacțiune descris mai jos 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 poate 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

Funcționalitatea CheckAccount este utilizată în a doua metodă de generare a facturii, unde BPay creează automat factura pentru client. Aceasta permite verificarea existenței unui cont la comerciant înainte de generarea facturii, asigurând corectitudinea datelor introduse de client.

La etapa Check Account, sistemul BPay va efectua o solicitare către sistemul comerciant, după următoru format:

{
    "merchantid": "test_merchant",
    "comand": "check",
    "order_id": "123456789",
    "amount": 10000,
    "valute": 498,
    "params": {
        "customer_name": "John Doe",
        "phone_number": "069123456",
        "email": "john.doe@example.com"
    }
}

După primirea solicitării, trebuie să ne răspundeți în format JSON corespunzător:

» Formatul: JSON

{
 'code' => 100,
 'text' => "success"
}

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.

 <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

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

<?php

$secretKey="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 . $secretKey);
?>

 <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.).