Оплата

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

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

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

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

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

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

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

URL: https://api.{ URL сервера }/api/v1/transaction/create/nagad?secret={pluginapi_secret}

На данном этапе мы предоставляем реквизиты кошелька, на который пользователь должен произвести платеж.

Request method:
POST

Format:
JSON

Parameters:

{
  'currency': 'BDT', 
  'label': 'eligendi'
}

{
    "status": "ok",
    "params": {
        "identifier": "324342342",
		"account_type": "personal" //Тип кошелька/аккаунта. Возможные значения: agent - агентский аккаунт, personal - персональный аккаунт, merchant - мерчант аккаунт.
    }
}

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

Способ оплаты в зависимости от типа аккаунта Nagad

Пользователь Клиента переходит в сервис Nagad и проводит там оплату в зависимости от типа аккаунта предоставленного кошелька.

На персональный аккаунт через "Send money".

На агентский аккаунт через "Cash out".

На мерчант аккаунт через "Merchant Pay".

Активация платежа

URL: http://api.{ URL сервера }/api/v1/transaction/activate?secret={pluginapi_secret}

На данном этапе пользователь передает номер транзакции, который вы пересылаете на сторону Paykassma для активации.

Request method:
POST

Format:
JSON

Parameters:

{
    "currency_code": "BDT",
    "wallet_type": "nagad",
    "label": "55",
    "amount": 500,
    "key1": "21NO1YRT",
    "custom_transaction_id": "123465477897"
}

{
    "status": "ok",
    "deposit": true,
    "deposit_amount": 500,
    "currency": {
        "code": "BDT",
        "symbol": "BDT"
    }
}

{
    "status": "pending",
    "message": "The deposit status check has been started. The operation may take longer than expected. Upon completion of the verification, the funds will be credited to your account"
}

{
    "status": "possible_transaction_created",
    "message": "Transaction not found. Possible transaction created"
}

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

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

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

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

{
    "signature": "56beb10ead1cd49475f1e16dd668a29fff3d4fb9",
    "wallet_type": "nagad",
    "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",
            "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": ""
            }
        }
    ]
}

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

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

Создание вывода Nagad

URL: https://api.{ URL сервера }/v2/withdrawal/create

Request method:

POST

Format:
JSON

Parameters:

{
"withdrawal_id": "af84c26f-931d-4c28-a30d-7b75e46b7685",
"payment_system": "nagad",
"amount": 6000,
"currency_code": "BDT",
"is_test": true,
"label": "c81594cc-e4b1-4ed5-914c-3817f2ccf13a",
"account_email": "[email protected]",
"account_number": "01642234663",
"signature": "98565041a9e126d325e864da0ba3d467f6ab0566"
}

{
    "status": "ok",
}

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

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

{
    "status": "fail",
    "message": {
        "withdrawals_sum_amount": [
            "Insufficient balance"
        ]
    }
}

Пример постбека на вывод Nagad

{
    "signature": "c36db9e7c7b45d429ee0ec5e4d2978cea1431287",
    "wallet_type": "nagad",
    "amount": 1000,
    "currency_code": "BDT",
    "label": "53928",
    "direction": "outgoing",
    "created_datetime": "2023-08-01 13:30:03",
    "access_key": "FQ9jMwrNSkFbyMNqYFf6Ed4xeKmjHK",
    "additional_data": [
        {
            "activated_datetime": "",
            "exchanger_identifier": "",
            "comment": "1",
            "amount": "1000",
            "currency_code": "BDT",
            "wallet_type": "nagad",
            "stockpiling_id": null,
            "transaction_id": "",
            "transaction_type": null,
            "plugin_custom_order_id": "",
            "withdrawal_id": "10304",
            "withdrawal_status": 5,
            "account_number": "123456789013",
            "account_name": "",
            "account_email": "",
            "bank_details": {
                "bank_code": null,
                "branch_code": null
            }
        }
    ]
}

После обработки вывода Paykassma пришлет постбек о результате вывода со статусом (withdrawal_status), подписанный сигнатурой.

Статусы выводов

Создание заявки на выплату в ЛК Paykassma

Для создания заявки на вывод, необходимо перейти на страницу Выводы (Оплаты → Выводы) и выполнить следующие шаги:

1. Нажмите на кнопку "Добавить заявку на вывод".
   
   
2. Выберите из списка нужную ПС.                                                            
3. Заполните поля для создания заявки в следующем окне (список полей стандартизирован и не все поля являются обязательными. Для создания заявки по определенной ПС, необходимо заполнить обязательные поля для этой ПС).

Обязательные поля для выплаты Nagad:
- Лейбл (ID пользователя)
- Сумма
- Валюта
- Кошелек получателя
- Email получателя


4. После оплаты статус вывода поменяется.


Paykassma не высылает постбек по выводам, созданным вручную.