P2P (МТБанк)
P2P (МТБанк)
Общее описание
Для ввода и вывода денежных средств на вашем сайте допускается использование плательщиком карт платежных систем MASTERCARD, VISA, БЕЛКАРТ. Типы карт, на которые может осуществляться вывод денежных средств, определяется банком-эквайером.
Разработка платежного модуля
Система WEBPAY предусматривает два способа формирования вывода денежных средств с использованием типа P2P:
- JSON API.
- Формирование стандартного POST-запроса.
Формирование стандартного POST-запроса
Обратите внимание
Все операции вывода денежных средств осуществляются с обязательной привязкой к операции ввода.
Для осуществления операции ввода и привязки карты необходимо сформировать один из следующих типов запросов:
В ответе будет передан transaction_id для осуществления в дальнейшем по нему вывода.
Вывод денежных средств
Для осуществления P2P вывода денежных средств необходимо сформировать стандартный POST-запрос (раздел Формирование заказа для оплаты) на адрес https://securesandbox.webpay.by/output/mtb для тестовой среды или https://payment.webpay.by/output/mtb для реальной среды, в который дополнительно передаются следующие поля:
| Название поля | Обязательное поле | Описание |
|---|---|---|
wsb_token_p2p | Да | Значение данного поля соответствует значению поля transaction_id, переданного в нотификаторе после осуществленной операции ввода и привязки карты |
wsb_output_via_corpocard_mtb | Да | Поле всегда содержит значение true и указывает на осуществление вывода денежных средств |
wsb_customer_id | Да | Уникальный идентификатор пользователя в Магазине. Поле не чувствительно к регистру |
Обратите внимание
При формировании запроса P2P на выплату денежных средств поля wsb_invoice_item_name, wsb_invoice_item_quantity, wsb_invoice_item_price являются необязательными.
Электронная подпись wsb_signature для формирования запроса P2P на выплату денежных средств должна быть сформирована согласно следующему правилу из значений следующих полей:
wsb_seedwsb_storeidwsb_customer_idwsb_order_numwsb_testwsb_currency_idwsb_totalSecretKey
Поля должны быть объединены в одну строку, порядок объединения не должен быть нарушен. Далее, в зависимости от указанной версии протокола (wsb_version), считается MD5 (если версия не указана), либо SHA1 (для версии 2) объединенной строки.
<form action="https://securesandbox.webpay.by/output/mtb" method="post">
<input type="hidden" name="*scart">
<input type="hidden" name="wsb_version" value="2">
<input type="hidden" name="wsb_storeid" value="240869199">
<input type="hidden" name="wsb_order_num" value="ORDER-1234567822223">
<input type="hidden" name="wsb_test" value="0">
<input type="hidden" name="wsb_currency_id" value="BYN">
<input type="hidden" name="wsb_seed" value="dfdasf3i232m13ijdsmcvm">
<input type="hidden" name="wsb_token_p2p" value="164941648452655">
<input type="hidden" name="wsb_output_via_corpocard_mtb" value="true">
<input type="hidden" name="wsb_customer_id" value="164968">
<input type="hidden" name="wsb_return_url" value="https://yoursiteurl.com/success.php">
<input type="hidden" name="wsb_cancel_return_url" value="https://yoursiteurl.com/cancel.php">
<input type="hidden" name="wsb_notify_url" value="https://yoursiteurl.com/notify.php">
<input type="hidden" name="wsb_total" value="1.00">
<!-- Значение SecretKey в примере равно 1 -->
<input type="hidden" name="wsb_signature" value="c6e16f9fa0837eff0585b1046431a134839fbc14">
<input type="submit" value="Выплатить">
</form>