Оплата

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

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

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

wallet_type=jazzcash_business
currency_code=PKR
Доступные языки (lang): en, ur (Урду)

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

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

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

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

В данном случае сначала мы принимаем запрос на ввод по платежной системе. Далее в ответе мы предоставим реквизиты кошелька, на который пользователь должен перевести платеж. После оплаты Вам необходимо отправить запрос на активацию транзакции.

Request method:

POST

Format:
JSON

Parameters:

{
  "currency": "PKR",
  "label": "eligendi"
}

{
    "status": "ok",
    "params": {
        "identifier": "00123456",
        "qr_data": "0002010102112606000205520456915802PK5915Rehmani clothes6010Sillanwali530358662420211032602162990611030419910590708004809246304EF63"
    }
}

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

Запрос активации

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

Request method:
POST

Format:
JSON

Parameters:

{
    "currency_code": "PKR",
    "wallet_type": "jazzcash_business",
    "label": "55",
    "key1": "473811134684",
	"amount": 500,
    "custom_transaction_id": "123465477897"
}

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

{
    "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'
}

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

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

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

{
    "signature": "0d8103294d3457bd4d22d0ff94c859d45ff9abb1",
    "wallet_type": "jazzcash_business",
    "amount": 700,
    "currency_code": "PKR",
    "label": "631317234",
    "converted_amount": {"USD": 4.61, "INR": 380, "EUR": 4.2, ... ,  "USDT": 4.60787289, "USDTTRC20": 0, "USDT20": 0},
    "direction": "ingoing",
    "created_datetime": "2023-08-25 10:47:40",
    "access_key": "FQ9jMwrNSkFbyMNqYFf6Ed4xeKmjHK",
    "additional_data": [
        {
            "activated_datetime": "2023-08-25 13:47:40",
            "exchanger_identifier": "99xxxx6690",
            "comment": "",
            "amount": "700",
            "currency_code": "PKR",
            "wallet_type": "jazzcash_business",
            "stockpiling_id": 1430926,
            "transaction_id": "047752123519",
            "transaction_type": 0,
            "plugin_custom_order_id": "h8JxcM123DbmAvfn",
            "withdrawal_id": null,
            "withdrawal_status": null,
            "account_number": "",
            "account_name": "",
            "account_email": "",
            "bank_details": {
                "bank_code": "",
                "branch_code": ""
        }
    ]
}

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

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

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

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

Request method:

POST

Format:
JSON

Parameters:

{
    "withdrawal_id": "297",
    "payment_system": "jazzcash",
    "amount": 1000,
    "currency_code": "PKR",
    "label": "125199",
    "account_number": "03278516234",
    "account_name": "TestNameAcc",
    "payments_details": {},
    "bank_details": {
        "bank_code": "3460342887803"
    },
    "is_test": false,
    "signature": "2237e83a44bba650d982edc043fc5dd39e9b816c"
}

{
    "status": "ok",
}

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

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

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

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

{
    "signature": "72ba3abd715986f6ba3b9d558c17074498f53d2c",
    "wallet_type": "jazzcash_business",
    "amount": 20000,
    "currency_code": "PKR",
    "label": "1237916",
    "converted_amount": {"USD": 9.19, "INR": 762, "EUR": 8.4, ... , "USDT": 9.20218423, "USDTTRC20": 0, "USDT20": 0},
    "direction": "outgoing",
    "created_datetime": "2023-08-24 16:52:02",
    "access_key": "FQ9jMwrNSkFbyMNqYFf6Ed4xeKmjHK",
    "additional_data": [
        {
            "activated_datetime": "",
            "exchanger_identifier": "",
            "comment": "",
            "amount": "20000",
            "currency_code": "PKR",
            "wallet_type": "jazzcash_business",
            "stockpiling_id": null,
            "transaction_id": "",
            "transaction_type": null,
            "plugin_custom_order_id": "",
            "withdrawal_id": "1071620",
            "withdrawal_status": 1,
            "account_number": "8541235719",
            "account_name": "",
            "account_email": "[email protected]",
            "bank_details": {
                "bank_code": null,
                "branch_code": null
            }
        }
    ]
}

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

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

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

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

1. Нажмите на кнопку "Добавить заявку на вывод".
   
   
   
   
2. Выберите из списка нужную ПС.
   
   
   
   
3. Заполните поля для создания заявки в следующем окне (список полей стандартизирован и не все поля являются обязательными. Для создания заявки по определенной ПС, необходимо заполнить обязательные поля для этой ПС).
   Обязательные поля для выплаты JazzCash business:
   - Лейбл (ID пользователя);
   - Сумма;
   - Валюта;
   - Кошелек получателя.
   
   
   
   4. После оплаты статус вывода поменяется.
   
   
   
   Paykassma не высылает постбек по выводам, созданным вручную.