// Должно присутствовать в коде:

// 1. обработчик успешного платежа
} else if (update.hasMessage() && update.getMessage().hasSuccessfulPayment()) {
    handler.successfulPaymentHandler(update.getMessage().getSuccessfulPayment());
                    
// 2. проверка
} else if (update.hasPreCheckoutQuery()) {
  handler.paymentPreCheckout(update.getPreCheckoutQuery());
  

/* ВОТ ТАКОЕ РАБОЧЕЕ, ГОТОВОЕ НЕПРОСТО НАЙТИ, ДЕЛЮСЬ */
  
// Проверка перед платежом. 
// AnswerPreCheckoutQuery прям должен быть в коде!
    public void paymentPreCheckout(PreCheckoutQuery query) {
        AnswerPreCheckoutQuery answer = new AnswerPreCheckoutQuery();

        if (query != null && query.getInvoicePayload().startsWith("avandy-news")) {
            answer.setOk(true);
            answer.setPreCheckoutQueryId(query.getId());
        } else {
            answer.setOk(false);
            answer.setErrorMessage("Попробуйте снова!");
        }

        try {
            messageService.execute(answer);
        } catch (TelegramApiException e) {
            log.error("paymentPreCheckout error = {}", e.getMessage());
        }
    }
  
// Обработчик успешного платежа
// ВАЖНО! в sum учитываются копейки, т.е. 25000 = 250,00 рублей
    public void handlePayment(SuccessfulPayment successfulPayment) {
        String payload = successfulPayment.getInvoicePayload();
        long chatId = Long.parseLong(payload.substring(payload.indexOf("#") + 1));
        String currency = successfulPayment.getCurrency();
        String providerPaymentChargeId = successfulPayment.getProviderPaymentChargeId();

        if (successfulPayment.getInvoicePayload().startsWith("avandy-news")) {
            Integer totalAmount = successfulPayment.getTotalAmount(); // здесь 25000
            // в базу запишем реальные 250 рублей, а не 25000 копеек
            double sum = (double) totalAmount / 100; // Учитываются копейки, т.е. 25000 = 250р.

            // Сохранить чек в БД
            // сохраняйте String providerPaymentChargeId, так потом проще возврат оформить
            paymentsService.save(new Payments(chatId, sum, currency, providerPaymentChargeId));
            sendMessage(chatId, "Оплата прошла успешно! " + premiumActivatedText);
        } else {
            sendMessage(chatId, "Ошибка оплаты, попробуйте снова!");
        }
    }

  // Выставление счёта через Юкассу
    public void getInvoice(long chatId, int type) {
        String description = "Подписка на получение премиальных возможности бота";
        List<LabeledPrice> labeledPrices = new ArrayList<>();
        String label = pay1month;       
        labeledPrices.add(new LabeledPrice(label, type * 100)); // умножаем на 100, чтобы были копейки 00

        try {
            SendInvoice invoice = getSendInvoice(chatId, description, labeledPrices);
            
            // Отправка счёта
            messageService.execute(invoice);
            
        } catch (TelegramApiException e) {
            log.error("{}: {} {}", "Ошибка при отправке счёта на оплату", chatId, e.getMessage());
        }

    }

  /* И ВОТ САМЫЙ СОК, СКОЛЬКО Ж Я НАМУЧИЛСЯ С МЕЛОЧАМИ */ 
    // Создание чека/инвоиса на одну услугу
    private SendInvoice getSendInvoice(long chatId, String description, List<LabeledPrice> labeledPrices) {
        SendInvoice invoice = new SendInvoice();
        String label = labeledPrices.get(0).getLabel();
        int amount = labeledPrices.get(0).getAmount() / 100;

        // Если телефон не сохранён в БД, то запроси его при платеже
        // иначе некуда отправлять чек ФНС. Это обязательное требование.
        // Можно запрашивать email. Т.е. или email или телефон должны быть,
        // если выбрана авто отправка чеков в ФНС и покупателю (фискализация)
        // ВАЖНО! А вот здесь уже 25000 != 250р. Дурдом :) 
        // поэтому предыдущие 25000 делим на 100
       String phoneNumber = userService.getPhoneNumber(chatId);        
       if (phoneNumber == null || phoneNumber.isEmpty()) {
            invoice.setNeedPhoneNumber(true);
            invoice.setSendPhoneNumberToProvider(true);
        }

        invoice.setChatId(String.valueOf(chatId));
        invoice.setProviderToken(PROVIDER_TOKEN); //Токен получаете после подписания договора
        invoice.setTitle("Avandy News");
        invoice.setDescription(description);
        invoice.setPayload("avandy-news#" + chatId);
        invoice.setStartParameter("payment-invoice");
        invoice.setCurrency("RUB");
        invoice.setPrices(labeledPrices);

        // Без этого тоже не пройдёт платёж, т.к. подключена фискализация
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("receipt",
                new JSONObject()
                        .put("items", new JSONArray().put(
                                new JSONObject()
                                        .put("description", label)
                                        .put("amount", new JSONObject()
                                                .put("value", amount + ".00") // ВОТ ДОГАДАЙСЯ САМ, ЧТО НАДО ТАК!!
                                                .put("currency", "RUB"))
                                        .put("vat_code", 1) // Это НДС так называется, 1 значит БЕЗ НДС
                                        .put("quantity", 1))));
        invoice.setProviderData(jsonObject.toString());

        return invoice;
    }
  

// Цепь приглашённых пользователей и расчёт бонуса, исходя из уровня [1 ур.-10%, 2-3 ур.-5%, >= 4 ур.-1%]
@NamedNativeQuery(
        name = "FindReferalls",
        query = "with recursive referral_chain as (select *, 0 as level from users where chat_id = ?1" +
                "                                  union all" +
                "                                  select u.*, r.level + 1 from users u" +
                "                                      join referral_chain r on u.referall_id = r.chat_id)" +
                " select level," +
                "        r.chat_id," +
                "        coalesce(r.user_name, r.first_name) as user_name," +
                "        sum," +
                "        case" +
                "            when (p.sum > 0 and r.level = 1) then p.sum * 0.10" +
                "            when (p.sum > 0 and r.level in (2, 3)) then p.sum * 0.05" +
                "            when (p.sum > 0 and r.level >= 4) then p.sum * 0.01" +
                "            else 0 end as award, " +
                "        p.currency," +
                "        r.referall_theme" +
                "  from referral_chain r " +
                "    left join payments p on p.chat_id = r.chat_id" +
                " where r.chat_id != ?1" +
                " order by r.level, r.user_name",
        resultSetMapping = "ReferallResultMapping")