Оплата

  1. Пользователь вводит сумму и номер своего кошелька Nagad API.
  2. Происходит редирект пользователя на платежную страницу Nagad API.
  3. Пользователь совершает оплату на стороне Nagad API - вводит пин, отп.
  4. Paykassma отсылает постбек на сторону мерчанта.
  5. Средства начисляются на баланс пользователя на платформе мерчанта.

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

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

https://plugin/.{URL_сервера}/?
label=label
&currency_code=BDT
&lang=en
&wallet_type=nagad_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=nagad_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/nagad_api?secret={pluginapi_secret}

Request method:
POST

Format:
JSON

Parameters:

NameTypeRequiredDescription
secretstringyesКлюч доступа.

Body:

Name

Type

Required

Max Length

Description

amount

float 

yes

ограничена min и max.
депозитом

Сумма платежа.
currencystringyes3Код валюты. 
labelstring yes190Это уникальный идентификатор (ID) пользователя, осуществляющего платеж.
custom_transaction_idstringyes190Идентификатор транзакции в системе Клиента. Должен быть уникальным.
success_urlstringyesне ограниченСсылка, по которой нужно перенаправить пользователя со страницы Nagad API в случае успешной оплаты.
fail_urlstringyesне ограниченСсылка, по которой нужно перенаправить пользователя со страницы Nagad API в случае ошибки оплаты.
cancel_urlstringyesне ограничен

Ссылка, по которой нужно перенаправить пользователя со страницы Nagad API в случае отмены оплаты.


Request
{
    "custom_transaction_id": "custom_transaction_1",
    "amount": 100,
    "currency": "BDT",
    "label": "test_user",
    "success_url": "https://success_url.com",
    "fail_url": "https://fail_url.com",
    "cancel_url": "https://cancel_url.com"
}
Response Success
{
    "status": "ok",
	"payment_url": "Nagad_URL"//ссылка на страницу оплаты Nagad, на которой пользователь должен ввести все необходимые реквизиты и совершить оплату.
}
Response Fail
{
    'status': 'fail',
    'message': 'MESSAGE'
}


Постбек депозита

Общую документацию по постбекам смотрите здесь.

Пример постбека на депозит Nagad API

{
    "signature": "56beb10ead1cd49475f1e16dd668a29fff3d4fb9",
    "wallet_type": "nagad_api",
    "amount": 600,
    "currency_code": "BDT",
    "label": "234",
    "direction": "ingoing",
    "created_datetime": "2023-08-20 19:04:08",
    "access_key": "FQ9jMwrNSkFbyMNqYFf6Ed4xeKmjHK",
    "additional_data": [
        {
            "activated_datetime": "2023-08-20 22:04:07",
            "exchanger_identifier": null,
            "comment": "",
            "amount": "600",
            "currency_code": "BDT",
            "wallet_type": "nagad_api",
            "stockpiling_id": 1061,
            "transaction_id": "52AD1EA4",
            "transaction_type": 1,
            "plugin_custom_order_id": "1234",
            "withdrawal_id": null,
            "withdrawal_status": null,
            "account_number": "",
            "account_name": "",
            "account_email": "",
            "bank_details": {
                "bank_code": "",
                "branch_code": ""
            }
        }
    ]
}

Сервер Paykassma ожидает ответ в json {"status":"ok"} код ответа 200, в противном случае, при получении отличающегося ответа, Paykassma будет пересылать постбек с определенной периодичностью.
На повторные постбеки необходимо также отвечать {"status":"ok"} код ответа 200.

Выводы / выплаты пользователям

Выплаты пользователям осуществляются через метод Nagad (подробнее про метод  Nagad смотрите здесь).

Оглавление: