วิธีเชื่อมต่อระบบการชำระเงิน

ระบบการชำระเงินถูกสร้างไว้ใน Telegram แล้ว หากต้องการรับชำระเงินภายในแอปพลิเคชัน คุณต้อง:

  • เชื่อมต่อระบบการชำระเงินกับบอทของคุณโดยใช้ BotFather
  • ไปที่การตั้งค่าบอทที่ต้องการ และเลือก "การชำระเงิน" จากเมนู

ทำตามคำแนะนำเพื่อเชื่อมต่อระบบการชำระเงินที่มีอยู่ และคัดลอกโทเค็นที่ได้รับ

วิธีออกใบแจ้งหนี้ให้ลูกค้า

หากต้องการส่งใบแจ้งหนี้ใน Telegram ให้ใช้เมธอดและระบุพารามิเตอร์ที่จำเป็น

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)

สำคัญ! พารามิเตอร์ทั้งหมดต้องถูกส่งตามลำดับที่ระบุในฟังก์ชัน หากคุณต้องการระบุพารามิเตอร์บางตัวและละเว้นพารามิเตอร์อื่น ให้ปล่อยค่าไว้เป็นค่าว่างหรือค่าตามที่ระบุในเอกสารสำหรับพารามิเตอร์ที่คุณไม่ต้องการ

ตัวอย่าง:

หากเปิดใช้งานพารามิเตอร์ need_name, need_phone_number หรือ need_email ใดๆ ผู้ใช้จะถูกขอให้ระบุข้อมูลนั้นก่อนดำเนินการชำระเงิน เมื่อชำระเงินสำเร็จ ข้อมูลจะถูกบันทึกไปยังตัวแปรของลูกค้าที่เกี่ยวข้อง

ตัวอย่าง:

ผลลัพธ์: ข้อมูลจะถูกขอให้กรอกก่อนการชำระเงิน

การตอบกลับการชำระเงิน

หากการชำระเงินสำเร็จ การตอบกลับที่มีเนื้อหาต่อไปนี้จะถูกส่งไปยังแชทของผู้ใช้:

tg_payment 1372995196 120.75 USD 2ff747b9-000f-5000-b000-16d7e3517aa', โดยที่

  1. course_pay - payload - payload จากการร้องขอสร้างใบแจ้งหนี้เดิม;
  2. 1372995196 - ID ของแชทที่ส่งใบแจ้งหนี้เดิม;
  3. 120.75 - จำนวนเงินที่ชำระทั้งหมด;
  4. USD - สกุลเงิน;
  5. 2ff747b9-000f-5000-b000-16d7e3517aa9 - ID การชำระเงินในระบบของผู้ค้า

นอกจากนี้ หากมีการขอชื่อผู้ใช้ หมายเลขโทรศัพท์ และ/หรืออีเมล ตัวแปรที่เกี่ยวข้องจะถูกกำหนดให้กับลูกค้า:

tg_payment_name, tg_payment_phone และ tg_payment_email

การตอบกลับการชำระเงินที่สำเร็จจะถูกส่งไปยัง ข้อความโดยตรง ของผู้ใช้กับบอท

ผู้ใช้ ต้องมีแชทที่มีอยู่แล้ว กับบอท (เช่น ต้องเริ่มต้นหรือสมัครรับข้อมูลบอท) ก่อน การชำระเงิน มิฉะนั้น บอทจะไม่สามารถส่งข้อความโดยตรงถึงพวกเขาได้

เมื่อได้รับเว็บฮุคการชำระเงินแล้ว การชำระเงินจะถูกยืนยันโดยอัตโนมัติผ่านเมธอด answerPreCheckoutQuery https://core.telegram.org/bots/api#answerprecheckoutquery

ข้อความปักหมุดพร้อมปุ่มชำระเงิน

คุณต้องใช้ฟีเจอร์ปักหมุดข้อความหลังจากเชื่อมต่อระบบการชำระเงิน

tg_pin_chat_message(platform_id, message_id, disable_notification)

ตัวอย่าง:

ขั้นตอนที่ 1:
prices = [["course", 100], ["VAT", 20.75]]

result=tg_send_invoice('381764678:TEST:129736', platform_id, 'Course on courses', 'Creating courses is easy', 'USD', prices, 'https://salebot.pro/promo.png', 'course_pay','0', '0', '1', '1', '1', '', '{"inline_keyboard": [[{"text":"Pay", "pay":"True"}]]}')

ขั้นตอนที่ 2:
จากผลลัพธ์ของขั้นตอนแรก คุณจะได้รับการตอบกลับ ซึ่งคุณต้องแยกค่า message_id โดยใช้ฟังก์ชัน get()
res=get(result,'result')
m_id=get(res,'message_id')

จากนั้น ปักหมุดข้อความ: tg_pin_chat_message(#{platform_id}, #{m_id}, 1)

ตัวอย่าง: ชุดพารามิเตอร์ขั้นต่ำ

prices = [["super course", 100]]

result= tg_send_invoice('381764678:TEST:129736', platform_id, 'Course on courses', 'Creating courses is super easy', 'USD', prices)

ตัวอย่าง: คีย์บอร์ด

prices = [["course", 100], ["VAT", 20.75]]

tg_send_invoice('381764678:TEST:129736', platform_id, 'Course on courses', 'Creating courses is easy, 'USD', prices, 'https://mavibot.ai/promo.png', 'course_pay','0', '0', '1', '1', '1', '', '{"inline_keyboard": [[{"text":"Pay", "pay":"True"}], [{"text":"Another button", "callback_data": "Another button"}]]}')