Page History
Оплата
- Пользователю предоставляются реквизиты кошелька, на которые необходимо совершить оплату.
- Пользователь совершает оплату в своем приложении кошелька и получает уникальный номер транзакции.
- Пользователь вводит уникальный номер транзакции в платежном окне - активирует транзакцию.
- Paykassma отправляет постбек на сторону мерчанта.
- Средства начисляются на баланс пользователя на платформе мерчанта.
Интеграция через платежное окно (plugin)
Пример ссылки на открытие платежного окна Wavepay:
https://plugin.{ URL сервера }/?label=label& |
|---|
| Code Block |
|---|
wallet_type=wavepay currency_code=MMK Доступные языки (lang): en, my (Бирманский) |
| Info |
|---|
Обратите внимание на описание параметров 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'ов (подробнее про хеширование см. здесь). |
Описание всех параметров плагина смотрите здесь.
Создание платежа
URL: https://api.{ URL сервера }/api/v1/transaction/create/wavepay?secret={pluginapi_secret}
На данном этапе мы предоставляем реквизиты кошелька, на который пользователь должен произвести платеж.
Request method:
POST
Format:
JSON
Parameters:
Name | Type | Required | Max Length | Description |
| currency | string | yes | 3 | Код валюты. |
label | string | yes | 190 | Это уникальный идентификатор (ID) пользователя, осуществляющего платеж. |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
'currency': 'MMK',
'label': 'eligendi'
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"status": "ok",
"params": {
"identifier": "324342342"
}
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
'status': 'fail',
'message': 'MESSAGE'
} |
Запрос активации
URL: http://api.{ URL сервера }/api/v1/transaction/activate?secret={pluginapi_secret}
На данном этапе юзер передает номер транзакции, который вы пересылаете на сторону Paykassma для активации.
Request method:
POST
Format:
JSON
Parameters:
Name | Type | Required | Max Length | Description | ||
| currency_code | string | yes | 3 | Код валюты. | ||
wallet_type | string | yes | 190 | Метод. | ||
| label | string | yes | 190 | Это уникальный идентификатор (ID) пользователя, осуществляющего платеж. | ||
| key1 | string | yes | 11 | Transaction_ID, полученный от пользователя.
| ||
| amount | float | yes | 256 | Сумма платежа. | ||
| custom_transaction_id | string | yes | 190 | Идентификатор транзакции в системе Клиента. Должен быть уникальным. |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"currency_code": "MMK",
"wallet_type": "Wavepay",
"label": "55",
"amount": 500,
"key1": "1394646476",
"custom_transaction_id": "123465477897"
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"status": "ok",
"deposit": true,
"deposit_amount": 6000,
"currency": {
"code": "MMK",
"symbol": "MMK"
}
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"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"
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"status": "possible_transaction_created",
"message": "Transaction not found. Possible transaction created"
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
'status': 'fail',
'message': 'MESSAGE'
} |
Постбек депозита
Общую документацию по постбекам смотрите здесь.
Создание вывода
URL: https://api.{ URL сервера }/v2/withdrawal/create
Request method:
POST
Format:
JSON
Parameters:
Name | Type | Required | Description |
| withdrawal_id | string(1-36) | yes | Идентификатор вывода, если параметр не передается, то система генерирует withdrawal_id. |
| payment_system | string | yes | Платежная система. |
| amount | int | required | Дополнительные требования:
|
| currency_code | string(3) | yes | Код валюты. |
is_test | boolean | yes | Параметр is_test может принимать одно из двух значений:
|
label | string(1-36) | yes | Label пользователя, для которого проводится вывод. |
| account_email | string | yes | Е-mail держателя счета. |
| account_number | string | yes | Номер счета получателя, 10-11 цифр. |
| signature | string | yes | Подпись, формируемая с private_key. |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"withdrawal_id": "af84c26f-931d-4c28-a30d-7b75e46b7685",
"payment_system": "wavepay",
"amount": 20000,
"currency_code": "MMK",
"is_test": true,
"label": "c81594cc-e4b1-4ed5-914c-3817f2ccf13a",
"account_email": "[email protected]",
"account_number": "01642234663",
"signature": "98565041a9e126d325e864da0ba3d467f6ab0566"
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"status": "ok",
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
'status': 'fail',
'message': 'MESSAGE'
} |
*Если при попытке создания заявки на вывод сумма балансов счетов в валюте заявки будет меньше, чем общая сумма новой и еще незавершенных заявок, то отобразится ошибка 'Недостаточный баланс' (для настройки данного функционала обратитесь в ТП Paykassma).
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"status": "fail",
"message": {
"withdrawals_sum_amount": [
"Insufficient balance"
]
}
} |
Пример постбека на вывод Wavepay
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"signature": "80dea4b4ac348b3362a6ae8a384bda273090d736",
"wallet_type": "wavepay",
"amount": 20000,
"currency_code": "MMK",
"label": "53999",
"converted_amount": {"USD": 9.19, "INR": 762, "EUR": 8.4, "IDR": 139456.4, "MYR": 41.85, "VND": 218252.65, "SGD": 12.34, "THB": 319.65, "NGN": 7059.31, "TRY": 248.14, "AED": 33.76, "CAD": 12.29, "AUD": 14.01, "BDT": 1000, "AFN": 782.21, "ALL": 880.95, "AMD": 3553.15, "AOA": 7606.14, "ARS": 2556.17, "AWG": 16.57, "AZN": 15.63, "BAM": 16.41, "BBD": 18.38, "BGN": 16.42, "BHD": 3.47, "BIF": 25985.39, "BMD": 9.19, "BND": 12.32, "BOB": 63.39, "BRL": 45.21, "BSD": 9.19, "BTC": 0.00031527, "BTN": 759.15, "BWP": 123.06, "BYN": 23.16, "BZD": 18.49, "CDF": 22761.01, "CHF": 8.07, "CLF": 0.28, "CLP": 7825.36, "CNH": 66.09, "CNY": 66.01, "COP": 37354.96, "CRC": 4997.9, "CUC": 9.19, "CUP": 236.69, "CVE": 925.13, "CZK": 203.57, "DJF": 1633.46, "DKK": 62.6, "DOP": 518.16, "DZD": 1249.8, "EGP": 284.5, "ERN": 137.88, "ETB": 503.71, "FJD": 20.82, "FKP": 7.24, "GBP": 7.24, "GEL": 23.94, "GGP": 7.24, "GHS": 102.53, "GIP": 7.24, "GMD": 555.18, "GNF": 78901.88, "GTQ": 72.13, "GYD": 1919.37, "HKD": 71.77, "HNL": 225.63, "HRK": 63.29, "HTG": 1256.82, "HUF": 3290.49, "ILS": 33.88, "IMP": 7.24, "IQD": 12017.81, "IRR": 388924.19, "ISK": 1215.7, "JEP": 7.24, "JMD": 1419.83, "JOD": 6.51, "JPY": 1311.31, "KES": 1314.41, "KGS": 806.76, "KHR": 37931.08, "KMF": 4134.66, "KPW": 8272.54, "KRW": 12026.76, "KWD": 2.83, "KYD": 7.64, "KZT": 4085.16, "LAK": 178275.46, "LBP": 137706.07, "LKR": 2935.82, "LRD": 1714.25, "LSL": 170.49, "LYD": 44.17, "MAD": 90.83, "MDL": 161.83, "MGA": 40949.06, "MKD": 516.95, "MMK": 19265.17, "MNT": 31711.4, "MOP": 73.76, "MRO": 0, "MRU": 347.91, "MUR": 415.74, "MVR": 141.09, "MWK": 9637.55, "MXN": 159.13, "MZN": 587.12, "NAD": 171.88, "NIO": 335.77, "NOK": 93.87, "NPR": 1214.64, "NZD": 15.12, "OMR": 3.54, "PAB": 9.19, "PEN": 33.46, "PGK": 33.33, "PHP": 512.31, "PKR": 2646.06, "PLN": 37.35, "PYG": 66768.73, "QAR": 33.47, "RON": 41.61, "RSD": 985.18, "RUB": 872.02, "RWF": 10882.98, "SAR": 34.48, "SBD": 76.92, "SCR": 121.87, "SDG": 5528.81, "SEK": 98.37, "SHP": 7.24, "SLL": 192745.54, "SOS": 5224.43, "SRD": 352.64, "SSP": 1197.31, "STD": 204807.82, "STN": 208.19, "SVC": 80.28, "SYP": 23094.44, "SZL": 170.64, "TJS": 100.59, "TMT": 32.17, "TND": 28.36, "TOP": 21.78, "TTD": 62.19, "TWD": 291.36, "TZS": 22933.31, "UAH": 338.83, "UGX": 33073.3, "UYU": 344.16, "UZS": 107221.29, "VEF": 0, "VES": 273.17, "VUV": 1091.26, "WST": 24.99, "XAF": 5511.18, "XAG": 0.39, "XAU": 0, "XCD": 24.84, "XDR": 6.83, "XOF": 5511.18, "XPD": 0.01, "XPF": 1002.59, "XPT": 0.01, "YER": 2301.14, "ZAR": 171.84, "ZMW": 176.38, "ZWL": 2959.73, "ETH": 0.00501297, "LTC": 0.11098363, "DOGE": 123.99061787, "DASH": 0.29568477, "BCH": 0.04051484, "ZEC": 0.31233151, "ETC": 0.51252969, "XRP": 13.94632462, "TRX": 118.36066918, "XLM": 65.99332558, "WAVES": 4.94463261, "USDT": 9.20218423, "USDTTRC20": 0, "USDT20": 0},
"direction": "outgoing",
"created_datetime": "2023-08-04 09:13:00",
"access_key": "FQ9jMwrNSkFbyMNqYFf6Ed4xeKmjHK",
"additional_data": [
{
"activated_datetime": "",
"exchanger_identifier": "",
"comment": "",
"amount": "20000",
"currency_code": "MMK",
"wallet_type": "wavepay",
"stockpiling_id": null,
"transaction_id": "",
"transaction_type": null,
"plugin_custom_order_id": "",
"withdrawal_id": "10319",
"withdrawal_status": 1,
"account_number": "56432467654",
"account_name": "",
"account_email": "[email protected]",
"bank_details": {
"bank_code": null,
"branch_code": null
}
}
]
} |
| Warning |
|---|
| Сервер Paykassma ожидает ответ в json {"status":"ok"} код ответа 200, в противном случае, при получении отличающегося ответа, Paykassma будет пересылать постбек с определенной периодичностью. На повторные постбеки необходимо также отвечать {"status":"ok"} код ответа 200. |
После обработки вывода Paykassma пришлет постбек о результате вывода со статусом, подписанный сигнатурой.
Статусы выводов
| 1 | SUCCESS | Статус для вывода, когда заявка на вывод была успешно обработана. |
| 5 | FAIL | Статус для вывода, когда заявка на вывод была отклонена. |
Создание заявки на выплату в ЛК Paykassma
Для создания заявки на вывод, необходимо перейти на страницу Выводы (Оплаты → Выводы) и выполнить следующие шаги:
- Нажмите на кнопку "Добавить заявку на вывод".
- Выберите из списка нужную ПС.
- Заполните поля для создания заявки в следующем окне (список полей стандартизирован и не все поля являются обязательными. Для создания заявки по определенной ПС, необходимо заполнить обязательные поля для этой ПС).
Обязательные поля для выплаты Mpesa:
- Лейбл (ID пользователя);
- Сумма;
- Валюта;
- Кошелек получателя.
4. После оплаты статус вывода поменяется
Paykassma не высылает постбек по выводам, созданным вручную.
Оглавление:
| Table of Contents | ||
|---|---|---|
|