Оплата

Пользователь вводит сумму и номер своего кошелька bKash в формате 01ХХХХХХХХХ, где X - цифра.
Происходит редирект пользователя на платежную страницу bKash.
Пользователь совершает оплату на стороне bKash - вводит пин, отп.
Paykassma отсылает постбек на сторону мерчанта.
Средства начисляются на баланс пользователя на платформе мерчанта.

Интеграция через платежное окно (plugin)

Пример ссылки на открытие платежного окна bKash:

`https://plugin.{URL_сервера}/?label=label&currency_code=BDT&lang=en&wallet_type=bkash_api&custom_transaction_id=custom_transaction_id&fixed_amount=fixed_amount &payment_url_success_id=2 &payment_url_pending_id=3&payment_url_fail_id=1 &success_url=hash &fail_url=hash &pending_url=hash`

wallet_type=bkash_api
currency_code=BDT
Доступные языки (lang): en, bn

Обратите внимание на описание параметров payment_url_success_id / payment_url_fail_id / payment_url_pending_id и success_url / fail_url / pending_url

Для использования payment_url_success_id / payment_url_fail_id / payment_url_pending_id необходимо передать URL'ы саппорту Paykassma, и использовать полученные ID в параметрах.

Для использования success_url / fail_url / pending_url необходимо использовать хэширование URL'ов (подробнее про хэширование см. здесь).

Описание всех параметров плагина смотрите здесь.

Интеграция через клиентский API

Создание платежа

http://api.{ URL сервера }/api/v1/payment/create/bkash_api?secret={pluginapi_secret}

Request method:
POST

Format:
JSON

Parameters:

Name	Type	Required	Description
secret	string	yes	Ключ доступа

Body:

Name	Type	Required	Max Length	Description
amount	float	yes	ограничена min и max. депозитом	Сумма платежа
account_number	string	yes	11	Одиннадцатизначный номер счета пользователя Клиента в Bkash, в формате 01ХХХХХХХХХ Валидация: Числа: 0-9
currency	string	yes	3	Код валюты
label	string	yes	190	Это уникальный идентификатор (ID) пользователя, осуществляющего платеж
custom_transaction_id	string	yes	190	Идентификатор транзакции в системе Клиента. Должен быть уникальным.
success_url	string	yes	не ограничен	Ссылка, на которую нужно перенаправить пользователя со страницы Bkash в случае успешной оплаты
failure_url	string	yes	не ограничен	Ссылка, на которую нужно перенаправить пользователя со страницы Bkash в случае ошибки оплаты
cancel_url	string	yes	не ограничен	Ссылка, на которую нужно перенаправить пользователя со страницы Bkash в случае отмены оплаты

{
    "amount": 1.00,
    "account_number": "01770618575",
    "currency": "BDT",
    "label": "test",
    "custom_transaction_id": "01abc0095689",
    "success_url": "https://static5.depositphotos.com/1029663/395/i/600/depositphotos_3955476-stock-photo-green-check-mark.jpg?status=success",
    "failure_url": "https://top-fon.com/uploads/posts/2021-07/1626870875_29-p-krasnii-krest-fon-32.png?status=failure",
    "cancel_url": "https://google.com/"
}

{
    "status": "ok",
    "data": {
        "orderId": "1cb4627a420a6e69",
        "bkashUrl": "https://sandbox.payment.bkash.com/redirect/tokenized/?paymentID=TR00114E1661778153815&hash=dcRq9geuCtjkN6rFpaGxdLAMrmyxIxL*kEN-p41SLL2M!xXy9m2OTUTLwlAGMVWDKyE8xkOHj_N_AHaTxNGT*(V2LXyC5y4zpUsG1661778154005&mode=0011&apiVersion=v1.2.0-beta",
        "message": "Successful"
    }
}

{
    'status': 'fail'
    'message': 'MESSAGE'
}

В случае успешного запроса создания платежа пользователю Клиента необходимо отобразить страницу, полученную в параметре "bkashUrl".

Шаги оплаты на странице Bkash

Шаг 1. Откроется форма для ввода номера счета пользователя в Bkash. Необходимо нажать на "Confirm" для перехода на следующий шаг оплаты.

Данные на первой форме Bkash заполняются автоматически, так как номер счета пользователя Клиента в Bkash уже передали в запросе создания платежа.

Документация по платформе > bKash API > image-2024-8-23_16-52-38.png

Шаг 2. Если номер счета оказался валидным, то откроется следующая форма для ввода кода ОТП. Необходимо на форме ввести ОТП и нажать на "Confirm".

Документация по платформе > bKash API > image-2024-8-23_16-53-29.png

Шаг 3. Если код ОТП корректный, то откроется следующая форма для ввода PIN. Необходимо ввести данные и нажать на "Confirm".

Документация по платформе > bKash API > image-2024-8-23_16-54-10.png

Шаг 4. Если PIN верный, то Bkash перенаправит пользователя по url, который отправили в запросе платежа.

Пример ниже представлен для неуспешного платежа.

Документация по платформе > bKash API > image-2024-8-23_16-54-43.png

После этого пользователю на какое-то время отобразится страница загрузки Paykassma (достаточно быстро, несколько секунд). Пример:

Документация по платформе > bKash API > image-2024-8-23_16-55-39.png

Страница загрузки закроется и пользователя перенаправит на нужную страницу в зависимости от статуса платежа:

В случае успешной оплаты → на success_url;
В случае ошибки платежа → на failure_url (при интеграции по API) или на fail_url (при интеграции через plugin).
В случае отмены платежа (если на шаге 1-3 пользователь нажал на кнопку "Close") → на cancel_url (доступно для интеграции по API). В случае интеграции через plugin - на fail_url.

Проверка статуса платежа (Необязательный этап)

http://api.{ URL сервера }/api/v1/payment/bkash_api/status?secret={pluginapi_secret}