Page History
Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Оплата
- Пользователю предоставляются реквизиты кошелька, на которые необходимо совершить оплату.
- Пользователь совершает оплату в своем приложении кошелька и получает уникальный номер транзакции.
- Пользователь вводит уникальный номер транзакции в платежном окне - активирует транзакцию.
- 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"
]
}
} |
Оглавление:
| Table of Contents | ||
|---|---|---|
|