Ilia Denisov
6e03ce0131
CI / changes (pull_request) Successful in 2s
CI / unit (pull_request) Successful in 22s
CI / integration (pull_request) Successful in 20s
CI / ui (pull_request) Successful in 1m10s
CI / conformance (pull_request) Successful in 10s
CI / gate (pull_request) Successful in 0s
CI / deploy (pull_request) Successful in 1m57s
Accept real money via Telegram Stars (XTR) — the third intake rail alongside Robokassa (direct) and VK Votes. Only the bot reaches Telegram, so the rail funnels through the reverse mTLS bot-link: - the gateway mints the invoice on a CreateInvoice command (the bot calls createInvoiceLink, XTR; the link goes to WebApp.openInvoice); - the bot gates each pre_checkout_query via a ValidatePreCheckout unary (the order must exist, be still creditable and not already paid — the reusable-invoice double-pay guard; the decline reason is localised to the order account's language); - a completed successful_payment is queued in a durable pure-Go SQLite outbox and forwarded via a ForwardPayment unary, credited once (idempotent on telegram_payment_charge_id, honours an expired order), re-driven on restart and every 30s. The rail is wired by TELEGRAM_STARS_OUTBOX_DIR (default /data) but stays inert until a chip pack carries an XTR price, so seeding a Stars price in the admin is the go-live. Tests: backend integration (order->forward->credit once, duplicate, pre_checkout gate) + bot outbox unit (idempotent, restart re-drive) + executor createInvoice. Docs: PAYMENTS(+ru) §9, ARCHITECTURE, the platform/telegram README, PLAN.
66 lines
2.2 KiB
Go
66 lines
2.2 KiB
Go
package botlink
|
|
|
|
import (
|
|
botlinkv1 "scrabble/pkg/proto/botlink/v1"
|
|
telegramv1 "scrabble/pkg/proto/telegram/v1"
|
|
)
|
|
|
|
// NotifyCommand builds an out-of-app push command rendered by the bot in the
|
|
// recipient's interface language.
|
|
func NotifyCommand(externalID, kind string, payload []byte, language string) *botlinkv1.Command {
|
|
return &botlinkv1.Command{
|
|
Payload: &botlinkv1.Command_Notify{Notify: &telegramv1.NotifyRequest{
|
|
ExternalId: externalID,
|
|
Kind: kind,
|
|
Payload: payload,
|
|
Language: language,
|
|
}},
|
|
}
|
|
}
|
|
|
|
// SendToUserCommand builds an admin text message addressed to one user.
|
|
func SendToUserCommand(externalID, text string) *botlinkv1.Command {
|
|
return &botlinkv1.Command{
|
|
Payload: &botlinkv1.Command_SendToUser{SendToUser: &telegramv1.SendToUserRequest{
|
|
ExternalId: externalID,
|
|
Text: text,
|
|
}},
|
|
}
|
|
}
|
|
|
|
// SendToGameChannelCommand builds an admin text message for the bot's game channel.
|
|
func SendToGameChannelCommand(text string) *botlinkv1.Command {
|
|
return &botlinkv1.Command{
|
|
Payload: &botlinkv1.Command_SendToChannel{SendToChannel: &telegramv1.SendToGameChannelRequest{
|
|
Text: text,
|
|
}},
|
|
}
|
|
}
|
|
|
|
// ChatGateCommand builds a chat-gate command that sets whether the Telegram user
|
|
// identified by externalID may write in the moderated discussion chat. The bot
|
|
// applies it only to a member currently in the chat (guarded on getChatMember).
|
|
func ChatGateCommand(externalID string, allow bool) *botlinkv1.Command {
|
|
return &botlinkv1.Command{
|
|
Payload: &botlinkv1.Command_ChatGate{ChatGate: &botlinkv1.ChatGateCommand{
|
|
ExternalId: externalID,
|
|
Allow: allow,
|
|
}},
|
|
}
|
|
}
|
|
|
|
// CreateInvoiceCommand builds a Telegram Stars invoice-mint command: the bot calls
|
|
// createInvoiceLink (in XTR) with the given title and description, the order id as the
|
|
// payload (echoed by Telegram in pre_checkout and successful_payment) and amountStars whole
|
|
// stars, and returns the link in its Ack result.
|
|
func CreateInvoiceCommand(title, description, orderID string, amountStars int64) *botlinkv1.Command {
|
|
return &botlinkv1.Command{
|
|
Payload: &botlinkv1.Command_CreateInvoice{CreateInvoice: &botlinkv1.CreateInvoiceCommand{
|
|
Title: title,
|
|
Description: description,
|
|
Payload: orderID,
|
|
Amount: amountStars,
|
|
}},
|
|
}
|
|
}
|