gopay

GoPay

Сервис для управления доступом к цифровым товарам, включающий прием платежей от клиентов и доставку им товаров после оплаты.

Функциональность

• Платежные провайдеры
  • ЮKassa
    • Создание платежных ссылок и прием платежей
    • Обработка уведомлений о совершении платежей
• Хранилища данных
  • BoltDB
    • Хранение данных о пользователях и их платежах и товарах
  • MinIO
    • Хранение продаваемых файлов
• Способы доставки
  • По ссылке в браузере
    • Генерация уникальных ссылок для доступа к цифровым товарам
• Виды цифровых товаров
  • PDF-файлы

Требования к окружению

• Go 1.23+
• GNU Make 3.80+ (опционально, для упрощения сборки)
• Docker Compose 2.17+ (опционально, для запуска MinIO)

Запуск и тестирование локально

Ниже представлена инструкция по использованию основных команд, для получения списка всех доступных команд воспользуйтесь make help.

Тестирование

Генерация mock-объектов и запуск unit-тестов:

make test

Запуск API

Предварительный запуск MinIO в docker-контейнере:

docker-compose up --build

Ниже приведены доступные настройки запуска API (флаг > переменная):

Пример сборки и запуска веб-сервера и API:

go run cmd/api/main.go --yookassa-checkout-url <gopay_checkout> --yookassa-shop-id <shop_id> --yookassa-api-token <api_token> --minio-user <user> --minio-password <password>

при локальном запуске (серый IP-адрес) уведомления от платежного сервиса (ЮKassa) приходить не будут

Документация API будет доступна после запуска по адресу: http://<GOPAY_HOST>:<GOPAY_PORT>/swagger/index.html

Запуск бота

Ниже приведены доступные настройки запуска бота (флаг > переменная):

Пример сборки и запуска Telegram-бота для управления сервисом:

go run cmd/bot/main.go --tg-bot-token <token> --tg-admin-ids <id1>,<id2>

Установка библиотеки

Также реализована библиотека для Go, которая предоставляет:

• PaymentManager
  • Объект с бизнес-логикой GoPay
• AdminClient
  • HTTP-клиент для GoPay API

Для установки библиотеки в другой проект на Go:

go get github.com/Anton-Kraev/gopay

Затем можно импортировать и использовать в своем проекте:

package main

import "github.com/Anton-Kraev/gopay"

const serverURL = "http://localhost:8080"

func main() {
	client, err := gopay.NewAdminClient(serverURL)
	if err != nil {
		print(err)
		return
	}
	
	statuses, err := client.NewAllPaymentService().Do()
	if err != nil {
		print(err)
		return
	}
	
	for id, status := range statuses {
		println(id, status)
	}
}