Оплата

Пользователь выбирает метод Ipay API и вводит сумму на платформе мерчанта.
Происходит переход пользователя на страницу оплаты.
Пользователь выбирает один из удобных способов оплаты: Ipay или LankaQR.

При оплате через Ipay:

Пользователь вводит необходимую информацию для дальнейшего подтверждения платежа: номер телефона и адрес электронной почты от аккаунта.
На телефон пользователя приходит пуш-уведомление с запросом на оплату.
Пользователь переходит в приложение и подтверждает оплату.

При оплате через LankaQR:

Пользователь сканирует QR-код в своем приложении Ipay через раздел QR pay.
Пользователь подтверждает оплату.

После подтверждения оплаты:

Paykassma отсылает постбек на сторону мерчанта.
Средства начисляются на баланс пользователя на платформе мерчанта.

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

Из-за особенностей работы ПС метод Ipay API (p2c) интеграция возможна только через плагин, при этом открытие страницы должно происходить через попап или в новой вкладке.

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

`https://plugin.{URL_сервера}/? label=label &currency_code=LKR &lang=lang &wallet_type=ipay_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=ipay_api
currency_code=LKR
Доступные языки (lang): en

Обратите внимание на описание параметров 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

Интеграция через API для данного метода недоступна.

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

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

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

{
    "signature": "910135b2a60d0a8f940db8c6e6cc8e334f90d937",
    "wallet_type": "ipay_api",
    "amount": 100,
    "currency_code": "LKR",
    "label": "1044289391",
    "converted_amount": {
        "USD": 0.34,
        "INR": 29,
        "EUR": 0.32,
        "IDR": 5423.46,
        ...
        "USDTTRC20": 0,
        "USDT20": 0
    },
    "direction": "ingoing",
    "created_datetime": "2024-11-06 13:10:01",
    "access_key": "PFOgBdC9NxcLWMGVH8lk",
    "additional_data": [
        {
            "activated_datetime": "2024-11-06 13:10:01",
            "exchanger_identifier": null,
            "comment": "",
            "amount": "100",
            "currency_code": "LKR",
            "wallet_type": "ipay_api",
            "stockpiling_id": 8,
            "transaction_id": "W000000000528349",
            "transaction_type": 0,
            "plugin_custom_order_id": "1343140123",
            "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.

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