Прием платежей на сайте

Мы предлагаем два типа выставления счетов: счет, созданный мерчантом, и счет, созданный системой BPay.

В первом случае инвойс создается мерчантом с использованием API, описанного ниже, и платформы pay.bpay.md. Во втором случае инвойс создается BPay на сайте или платежном терминале.

Описанный ниже механизм взаимодействия позволит вам выставлять пользователю счет на оплату с указанной вами суммой. Пользователь либо будет перенаправлен на страницу платежных услуг, где он сможет оплатить счет удобным способом, либо вы получите ссылку (URL) на этот счет, которую сможете отправить пользователю по электронной почте или сгенерировать QR-код.

Чтобы инициировать оплату через единую платежную форму, вам просто нужно отправить пользователя по специальному URL-адресу, а также указать ряд **обязательных параметров**.

Функциональность CheckAccount используется во втором методе генерации счета, где BPay автоматически создает счет для клиента. Это позволяет проверить существование счета у мерчанта до генерации счета, обеспечивая корректность данных, введенных клиентом.

На этапе Check Account система BPay отправит запрос в систему мерчанта в следующем формате:

{
    "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"
    }
}

После получения запроса вы должны ответить в соответствующем формате JSON:

» Формат: JSON

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

На вашем сайте вам нужно разместить форму, которая будет содержать два поля. Поле **data** содержит **xml** или **json** (в зависимости от используемого формата) с информацией, а поле **key** будет содержать подпись этих данных.

Нажатие на кнопку **Submit** перенаправит пользователя на платежную форму системы BPay.md. После осуществления платежа пользователь будет возвращен на страницу вашего сайта, указанную в **success_url**. В течение 15 секунд платежный сервис отправит уведомление о полученном платеже указанным вами способом.

Необходимо сформировать массив, закодированный в JSON, который, в свою очередь, закодирован в 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));

Для дополнительной безопасности ваших платежей мы осуществляем обязательную проверку цифровой подписи при создании платежа. Наличие подписи гарантирует защиту от подмены передаваемых значений (например, изменение суммы платежа или номера заказа).

» Формат: JSON

Подпись формируется путем объединения данных JSON с подписью, которая выдается при регистрации магазина. Затем необходимо сгенерировать хеш, используя алгоритм **sha256**.

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

 '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);
?>

 

 
 
 
 

Нажатие на кнопку **Submit** перенаправит плательщика на платежную форму системы BPay.md. После успешной оплаты пользователь будет возвращен на страницу вашего сайта, указанную в success_url. В течение 15 секунд мерчант (онлайн-магазин) получит уведомление о полученном платеже (указанным вами способом).