So schließen Sie ein Zahlungssystem an
Das Zahlungssystem ist in Telegram integriert. Um Zahlungen innerhalb des Messengers zu akzeptieren, müssen Sie:
- Ein Zahlungssystem über BotFather mit Ihrem Bot verbinden.
- Gehen Sie zu den gewünschten Bot-Einstellungen und wählen Sie "Zahlungen" aus dem Menü.
Folgen Sie den Anweisungen, um ein verfügbares Zahlungssystem zu verbinden, und kopieren Sie das bereitgestellte Token.
So stellen Sie einem Kunden eine Rechnung
Um eine Rechnung in Telegram zu senden, verwenden Sie die Methode und geben Sie die erforderlichen Parameter an.
tg_send_invoice(provider_token, platform_id, title, description, currency, prices, photo_url, payload, protect_content, disable_notification, need_name, need_phone_number, need_email, reply_to_message_id, reply_markup, message_thread_id, provider_data)
WICHTIG! Alle Parameter müssen in der in der Funktion angegebenen Reihenfolge übergeben werden. Wenn Sie einen bestimmten Parameter angeben und andere auslassen möchten, lassen Sie leere Werte oder Werte, wie in der Dokumentation für die nicht benötigten Parameter angegeben.
Beispiel:
Wenn einer der Parameter need_name, need_phone_number oder need_email aktiviert ist, wird der Benutzer aufgefordert, diese Informationen vor Abschluss der Zahlung anzugeben. Bei erfolgreicher Zahlung werden die Daten in den entsprechenden Client-Variablen gespeichert.
Beispiel:
Ergebnis: Daten werden vor der Zahlung angefordert.
Zahlungs-Callback
Bei erfolgreicher Zahlung wird ein Callback mit folgendem Inhalt an den Chat des Benutzers gesendet:
tg_payment 1372995196 120.75 USD 2ff747b9-000f-5000-b000-16d7e3517aa', wobei
- course_pay - payload - die Nutzlast aus der ursprünglichen Rechnungserstellungsanfrage;
- 1372995196 - die Chat-ID, in der die Rechnung ursprünglich gesendet wurde;
- 120.75 - der gesamte Zahlungsbetrag;
- USD - die Währung;
- 2ff747b9-000f-5000-b000-16d7e3517aa9 - die Zahlungs-ID im System des Händlers.
Zusätzlich, wenn der Name, die Telefonnummer und/oder die E-Mail des Benutzers angefordert wurden, werden die entsprechenden Variablen dem Client zugewiesen:
tg_payment_name, tg_payment_phone und tg_payment_email
Ein Zahlungserfolgs-Callback wird an die Direktnachrichten des Benutzers mit dem Bot gesendet.
Der Benutzer muss einen bestehenden Chat mit dem Bot haben (d. h. er muss den Bot gestartet oder abonniert haben) bevor die Zahlung getätigt wird. Andernfalls kann der Bot ihm keine Direktnachricht senden.
Sobald der Zahlungs-Webhook empfangen wird, wird die Zahlung automatisch über die Methode answerPreCheckoutQuery bestätigt. https://core.telegram.org/bots/api#answerprecheckoutquery
Angeheftete Nachricht mit einem Zahlungsbutton
Sie müssen die Funktion zum Anheften von Nachrichten verwenden, nachdem Sie das Zahlungssystem verbunden haben.
tg_pin_chat_message(platform_id, message_id, disable_notification)
Beispiel:
Schritt 1:
prices = [["Kurs", 100], ["MwSt.", 20.75]]
result=tg_send_invoice('381764678:TEST:129736', platform_id, 'Kurs über Kurse', 'Kurse erstellen ist einfach', 'USD', prices, 'https://salebot.pro/promo.png', 'course_pay','0', '0', '1', '1', '1', '', '{"inline_keyboard": [[{"text":"Bezahlen", "pay":"True"}]]}')
Schritt 2:
Als Ergebnis des ersten Schritts erhalten Sie eine Antwort, aus der Sie den Wert message_id mit der Funktion get() extrahieren müssen.
res=get(result,'result')
m_id=get(res,'message_id')
Als nächstes heften Sie die Nachricht an: tg_pin_chat_message(#{platform_id}, #{m_id}, 1)
Beispiel: minimaler Parametersatz
prices = [["Superkurs", 100]]
result= tg_send_invoice('381764678:TEST:129736', platform_id, 'Kurs über Kurse', 'Kurse erstellen ist super einfach', 'USD', prices)
Beispiel: Tastatur
prices = [["Kurs", 100], ["MwSt.", 20.75]]
tg_send_invoice('381764678:TEST:129736', platform_id, 'Kurs über Kurse', 'Kurse erstellen ist einfach', 'USD', prices, 'https://mavibot.ai/promo.png', 'course_pay','0', '0', '1', '1', '1', '', '{"inline_keyboard": [[{"text":"Bezahlen", "pay":"True"}], [{"text":"Ein weiterer Button", "callback_data": "Ein weiterer Button"}]]}')
