Обзор PS Wallet Pay

PS Wallet Pay — платёжная система PS Wallet для приёма криптовалюты в ваших ботах, сайтах и приложениях. Вы выставляете счёт через API — в монете, долларах или рублях, — пользователь оплачивает его в PS Wallet в пару нажатий, а деньги приходят на баланс вашего приложения. Оттуда их можно вывести на свой счёт, отправить пользователям переводом или чеком.

#Как это работает

1. Ваш сервер создаёт счёт методом createInvoice и получает ссылку на оплату.
2. Вы отправляете ссылку пользователю. Счёт открывается в PS Wallet: в чате бота с кнопкой оплаты или сразу на экране оплаты в мини-приложении.
3. Пользователь платит со своего счёта в PS Wallet.
4. Сумма оплаты за вычетом комиссии — 0.3% — зачисляется на баланс приложения, а если подключены вебхуки, ваш сервер сразу получает уведомление invoice_paid.
5. Деньги с баланса можно вывести на свои счета PS Wallet в кабинете или отправить пользователям через transfer и чеки.

#Начало работы

1. Откройте PS Wallet в Telegram (@pswallet) → «Профиль» → «PS Wallet Pay» → «Создать новое».
2. Задайте название, описание, ссылку на проект и логотип в разделе «Информация о приложении» — их видят ваши клиенты на экране оплаты.
3. Скопируйте токен в разделе «API-токен» (понадобится PIN-код). Токен даёт полный доступ к приложению, поэтому храните его только на сервере и никому не передавайте. Если токен утёк, нажмите «Перевыпустить»: старый перестанет работать сразу.
4. Если нужны уведомления об оплате, укажите адрес сервера в разделе «Вебхуки».
5. Если будете отправлять деньги пользователям, включите методы transfer и createCheck в разделе «Безопасность». По умолчанию они выключены.

#Как тестировать

Отдельной тестовой сети нет. Для разработки создайте отдельное приложение и проверяйте всё на небольших суммах: счета своего приложения можно оплачивать самому.

#Первый запрос

Проверьте токен методом getMe. Замените $TOKEN на токен своего приложения.

curl https://pay.pswallet.org/api/getMe \
  -H "PSWallet-Pay-API-Token: $TOKEN"

// Node.js 18+ (встроенный fetch)
const response = await fetch("https://pay.pswallet.org/api/getMe", {
  headers: { "PSWallet-Pay-API-Token": process.env.PSWALLET_PAY_TOKEN },
});
const data = await response.json();
console.log(data.result);

import os
import requests

response = requests.get(
    "https://pay.pswallet.org/api/getMe",
    headers={"PSWallet-Pay-API-Token": os.environ["PSWALLET_PAY_TOKEN"]},
    timeout=15,
)
print(response.json()["result"])

Ответ:

{
  "ok": true,
  "result": {
    "app_id": 1234,
    "name": "My Shop",
    "payment_processing_bot_username": "pswallet"
  }
}

#Методы API

#Разделы документации

• Запросы и ответы — адрес API, авторизация, формат параметров и ответов, лимит запросов.
• Монеты и суммы — коды монет, точность, USDT в любой сети, счета в долларах и рублях.
• Счета — createInvoice, getInvoices, deleteInvoice.
• Переводы — transfer, getTransfers.
• Чеки — createCheck, getChecks, deleteCheck.
• Приложение, баланс и курсы — getMe, getBalance, getExchangeRates, getCurrencies, getStats.
• Типы объектов — поля Invoice, Transfer, Check и других объектов.
• Вебхуки — уведомления об оплате, проверка подписи, повторы.
• Ошибки — формат и коды ошибок.
• Комиссия и лимиты — сколько стоит приём оплаты и какие есть ограничения.
• Безопасность — токен, разрешённые методы, белый список IP.