วิธีกำหนดค่า Robokassa

มาดูวิธีรับชำระเงินในบอทผ่านบริการ Robokassa กัน

  1. สร้างร้านค้าออนไลน์ในบัญชี Robokassa ของคุณและระบุการตั้งค่าทางเทคนิคดังต่อไปนี้:

สร้างรหัสผ่านทดสอบและทำการตั้งค่าเริ่มต้นในโหมดทดสอบ

วิธีเชื่อมต่อ Robokassa กับ MaviBot

ไปที่ส่วน การรับชำระเงิน แล้วคลิก เชื่อมต่อ บนการ์ด Robokassa:

กรอกแบบฟอร์มในหน้าต่างที่เปิดขึ้น:

  1. รหัสร้านค้า — Shop ID ซึ่งคุณสามารถหาได้จากการตั้งค่าร้านค้าในบัญชี Robokassa ของคุณ
  2. รหัสผ่าน #1 และ รหัสผ่าน #2 — ลำดับตัวอักษรและตัวเลขที่ไม่ซ้ำกันที่สร้างขึ้น
  3. อัตราภาษีมูลค่าเพิ่ม — ระบุรหัสที่เหมาะสมสำหรับการส่งค่าภาษีมูลค่าเพิ่ม ฟิลด์นี้กำหนดอัตราภาษีในเครื่องบันทึกเงินสด อัตราจะถูกกำหนดแยกต่างหากสำหรับสินค้าแต่ละประเภท แต่จะใช้กับทุกหน่วยของสินค้าประเภทนั้นร่วมกัน

ค่าที่มี:

  • ไม่มีภาษีมูลค่าเพิ่ม
  • ภาษีมูลค่าเพิ่ม 0%
  • ภาษีมูลค่าเพิ่ม 5%
  • ภาษีมูลค่าเพิ่มคำนวณที่ 12%
  • ภาษีมูลค่าเพิ่มคำนวณที่ 16%

วิธีสร้างลิงก์ชำระเงิน

คุณสามารถสร้างลิงก์ชำระเงินในบล็อกโดยใช้ วิธีใดวิธีหนึ่ง จากวิธีการที่มี:

ปุ่มชำระเงิน

คุณสามารถสร้างลิงก์ชำระเงินโดยใช้ปุ่มที่มีฟังก์ชัน การชำระเงิน

เรียนรู้วิธีสร้างปุ่มที่มีฟังก์ชัน การชำระเงิน ได้ที่นี่

มาดูพารามิเตอร์ทั้งหมดของปุ่มที่มีให้ใช้งาน

พารามิเตอร์ที่จำเป็นของปุ่มชำระเงิน

ในการสร้างลิงก์ชำระเงิน ให้ระบุพารามิเตอร์ที่จำเป็นต่อไปนี้ในการตั้งค่าปุ่ม:

  • จำนวนเงิน
  • ชื่อสินค้า

จำนวนเงิน — ระบุราคาสินค้าเป็นรูเบิล

ชื่อสินค้า — ฟิลด์นี้อาจมีเฉพาะตัวอักษรภาษาอังกฤษหรือรัสเซีย ตัวเลข และเครื่องหมายวรรคตอน ความยาวสูงสุดคือ 100 ตัวอักษร ข้อมูลนี้จะแสดงในอินเทอร์เฟซของ Robokassa และในใบเสร็จอิเล็กทรอนิกส์ที่ลูกค้าได้รับหลังจากชำระเงินสำเร็จ

ห้าม ใช้เครื่องหมายคำพูดคู่ในชื่อสินค้า ให้ลบออกหรือแทนที่ด้วยเครื่องหมายคำพูดเดี่ยว

ช่องทำเครื่องหมายการชำระเงินอัตโนมัติ — เปิดใช้งานการชำระเงินซ้ำ

ช่องทำเครื่องหมายการแจ้งเตือนการคลิก — เปิดใช้งานการติดตามการคลิกลิงก์ชำระเงิน หากเปิดใช้งาน การแจ้งเตือนเกี่ยวกับการคลิกจะปรากฏในบทสนทนาของลูกค้าใน MaviBot

คุณสามารถกำหนดค่าตรรกะของบอทเพิ่มเติมตามการแจ้งเตือนนี้

ระบบชำระเงินหลายระบบรองรับเครื่องบันทึกเงินสดออนไลน์บนคลาวด์ที่จำเป็นภายใต้กฎหมายของรัฐบาลกลางหมายเลข 54-FZ

ตรวจสอบข้อกำหนดของใบเสร็จบนเว็บไซต์ของผู้ให้บริการชำระเงินที่คุณเลือกเพื่อหลีกเลี่ยงปัญหากับหน่วยงานภาษี

ข้อมูลใบเสร็จ

เปิดเมนู ข้อมูลใบเสร็จ เพื่อแสดงพารามิเตอร์ของใบเสร็จ:

ชื่อสินค้า — จำเป็นสำหรับการสร้างใบเสร็จ

ห้าม ใช้เครื่องหมายคำพูดคู่ในชื่อสินค้า ให้ลบออกหรือแทนที่ด้วยเครื่องหมายคำพูดเดี่ยว

ยอดรวมเป็นรูเบิล — ระบุยอดชำระเงินทั้งหมดตามจำนวนสินค้า หากจำนวนคือ 1 ยอดรวมเป็นรูเบิลจะเท่ากับค่าที่ป้อนในฟิลด์ จำนวนเงิน ที่จำเป็น

จำนวน — จำนวนหรือน้ำหนักของสินค้า คุณสามารถส่งจำนวนเต็มหรือเลขทศนิยมโดยใช้จุด เช่น:

5

หรือ

10.3

ตัวแปรลูกค้าที่สร้างขึ้นโดยอัตโนมัติเมื่อใช้ปุ่มชำระเงิน

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

ตัวแปรบริการของลูกค้า:

__payments

เก็บจำนวนเงินที่ชำระและตัวระบุของลิงก์ชำระเงินที่สร้างขึ้น จำเป็นสำหรับการระบุเว็บฮุคที่ได้รับจากผู้ให้บริการชำระเงิน

ตัวแปรบริการ __payments ต้องไม่ ถูกลบหรือแก้ไข

ตัวแปรลูกค้า:

error_payment_button

ถูกสร้างขึ้นหากเกิดข้อผิดพลาดขณะสร้างปุ่มชำระเงิน

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

ค่าตัวแปรจะเป็นปัจจุบันหลังจากที่ผู้ใช้ย้ายไปยังบล็อกถัดไป

วิธีประมวลผลผลลัพธ์

โปรดทราบ

Robokassa ส่งการแจ้งเตือนเฉพาะธุรกรรมที่สำเร็จผ่าน URL ผลลัพธ์

Robokassa ไม่ มีการเรียกกลับสำหรับการชำระเงินที่ไม่สำเร็จ

URL ล้มเหลวเป็นเพียงหน้าเพจการชำระเงินที่ไม่สำเร็จซึ่งผู้ชำระเงินจะถูกเปลี่ยนเส้นทางไปหากเกิดข้อผิดพลาดบนหน้าเพจชำระเงิน

การชำระเงินสำเร็จ

หลังจากกำหนดค่าการชำระเงินอย่างถูกต้องและสร้างลิงก์ชำระเงินแล้ว ให้ทดสอบการตั้งค่า

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

การเรียกกลับประกอบด้วย:

  • 10 ตัวอักษรของคีย์ลับของผู้ให้บริการชำระเงิน
  • คำว่า _success
  • จำนวนเงินที่ชำระตามด้วยช่องว่าง

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

ตัวอย่าง:

ovg58keefc_success 2999

โดยที่:

  • ovg58keefc — 10 ตัวอักษรของคีย์ลับของผู้ให้บริการชำระเงิน
  • _success — ผลลัพธ์การประมวลผลคำขอที่ระบุว่าชำระเงินสำเร็จ
  • 2999 — จำนวนเงินที่ชำระ

การดำเนินการบล็อก:

การเรียกกลับ:

การเรียกกลับของผู้ให้บริการชำระเงิน ไม่ปรากฏ แก่ผู้ใช้

การเรียกกลับจะแสดงเฉพาะในส่วน ลูกค้า และมองเห็นได้เฉพาะผู้ปฏิบัติงานหรือผู้ดูแลระบบ

ตัวอย่างการกำหนดค่าการตอบสนองการเรียกกลับ

ในบล็อกแบบมีเงื่อนไข เช่น บล็อก เงื่อนไขเริ่มต้น หรือบล็อก ไม่มีสถานะพร้อมเงื่อนไข ให้ระบุการเรียกกลับที่ได้รับหลังการชำระเงิน

เลือก ตรงทั้งหมด หรือ มีคำสำคัญ เป็นประเภทการจับคู่

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

ข้อผิดพลาดจำนวนเงินชำระ

หากจำนวนเงินที่ระบุในการตั้งค่าปุ่มแตกต่างจากจำนวนเงินที่ลูกค้าชำระ บอทจะได้รับการเรียกกลับโดยอัตโนมัติซึ่งประกอบด้วย:

  • 10 ตัวอักษรของคีย์ลับของผู้ให้บริการชำระเงิน
  • _different_amounts
  • รหัสการชำระเงินที่ไม่ซ้ำกันตามด้วยช่องว่าง

ตัวอย่าง:

ovg58keefc_different_amounts 123456

โดยที่:

  • ovg58keefc — 10 ตัวอักษรของคีย์ลับของผู้ให้บริการชำระเงิน
  • _different_amounts — ระบุว่าจำนวนเงินที่ชำระแตกต่างจากจำนวนเงินในลิงก์ชำระเงิน
  • 123456 — รหัสการชำระเงินที่ไม่ซ้ำกัน

ฟังก์ชัน get_robokassa_payment_url ในเครื่องคิดเลข

คุณสามารถสร้างลิงก์ชำระเงินโดยใช้ฟังก์ชัน get_robokassa_payment_url ในบล็อกเครื่องคิดเลข

ในฟิลด์ เครื่องคิดเลข ให้กำหนดผลลัพธ์ของฟังก์ชัน get_robokassa_payment_url ให้กับตัวแปร

คุณสามารถเลือกชื่อตัวแปรได้เอง ภาพหน้าจอแสดงชื่อตัวแปรตัวอย่าง

ลิงก์ชำระเงินจะถูกบันทึกในตัวแปรนี้

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

ตัวอย่างลิงก์ชำระเงิน:

https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=test_salebot&OutSum=800&InvId=1412&IsTest=1&SignatureValue=0427369c3bd068bae30935f896060dda

ระบบชำระเงินหลายระบบรองรับเครื่องบันทึกเงินสดออนไลน์บนคลาวด์ที่จำเป็นภายใต้กฎหมายของรัฐบาลกลางหมายเลข 54-FZ

ตรวจสอบข้อกำหนดของใบเสร็จบนเว็บไซต์ของผู้ให้บริการชำระเงินที่คุณเลือกเพื่อหลีกเลี่ยงปัญหากับหน่วยงานภาษี

เครื่องคิดเลข

ตัวอย่างที่ 1:

คำอธิบายพารามิเตอร์

get_robokassa_payment_url(amount, description, products_for_receipt, recurrent, currency)

พารามิเตอร์ของฟังก์ชัน

พารามิเตอร์ คำอธิบาย
amount จำนวนเงินชำระ ระบุราคาสินค้าเป็นรูเบิล พารามิเตอร์ที่จำเป็น
description ชื่อสินค้า ฟิลด์นี้อาจมีเฉพาะตัวอักษรภาษาอังกฤษหรือรัสเซีย ตัวเลข และเครื่องหมายวรรคตอน ความยาวสูงสุดคือ 100 ตัวอักษร ข้อมูลนี้จะแสดงในอินเทอร์เฟซของ Robokassa และในใบเสร็จอิเล็กทรอนิกส์ที่ลูกค้าได้รับหลังจากชำระเงินสำเร็จ พารามิเตอร์ที่จำเป็น
products_for_receipt พารามิเตอร์การสร้างใบเสร็จ อ่านเพิ่มเติม ที่นี่
recurrent เปิดใช้งานการชำระเงินซ้ำ ส่ง 1 หากเปิดใช้งานการชำระเงินซ้ำ หรือ None หากปิดใช้งาน
currency รหัสสกุลเงินสามตัวอักษร ค่าต้องตรงกับพารามิเตอร์ที่ Robokassa ยอมรับอย่างเคร่งครัด

USD — ดอลลาร์สหรัฐ;
EUR — ยูโร;
KZT — เทงเจ

ตัวอย่างโค้ด

ตัวอย่างที่ 1: ลิงก์ชำระเงินโดยไม่มีใบเสร็จ

res = get_robokassa_payment_url(100, 'Buy me')

ตัวอย่างที่ 2: ลิงก์ชำระเงินพร้อมใบเสร็จ

receipt = [{"name":"DDDDDDDD","amount":"44","quantity":"1","vat_code":"5","method":"full_payment","object":"commodity"}]

res = get_robokassa_payment_url(100, 'Buy me', receipt, '3', 1, 1)

คุณสามารถแสดงตัวแปรเป็นลิงก์ในข้อความหรือวางไว้ในปุ่มที่มีข้อความเช่น ซื้อ

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

error_payment_func

ข้อผิดพลาดจากฟังก์ชันสุดท้ายในเครื่องคิดเลขจะถูกบันทึก

หลังจากกำหนดค่าการชำระเงินอย่างถูกต้องและสร้างลิงก์ชำระเงินแล้ว ให้ทดสอบการตั้งค่า

วิธีเพิ่มคำอธิบายการชำระเงิน

คุณสามารถเพิ่มคำอธิบายการชำระเงินโดยการตั้งค่าตัวแปร:

payment_description

คำอธิบายจะแสดงในแบบฟอร์มการชำระเงินและบนใบเสร็จ

วิธีประมวลผลผลลัพธ์

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

การเรียกกลับประกอบด้วย:

  • 10 ตัวอักษรของคีย์ลับของผู้ให้บริการชำระเงิน
  • _success
  • จำนวนเงินที่ชำระตามด้วยช่องว่าง

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

ตัวอย่าง:

ovg58keefc_success 1500

โดยที่:

  • ovg58keefc — 10 ตัวอักษรของคีย์ลับของผู้ให้บริการชำระเงิน
  • _success — ผลลัพธ์การประมวลผลคำขอที่ระบุว่าชำระเงินสำเร็จ
  • 1500 — จำนวนเงินที่ชำระ

โปรดทราบ

การเรียกกลับจะมองเห็นได้เฉพาะคุณในบทสนทนาของลูกค้า

การเรียกกลับไม่ปรากฏแก่ลูกค้า แต่คุณสามารถกำหนดค่าการตอบสนองต่อการชำระเงินที่สำเร็จได้

ตัวอย่าง

การตั้งค่าของบล็อกที่ใช้ฟังก์ชัน get_robokassa_payment_url:

1. การแสดงลิงก์ในข้อความ

สำคัญ

ลิงก์ชำระเงินไม่ซ้ำกัน คุณต้องไม่คัดลอกและส่งให้ลูกค้ารายอื่น

ส่งลิงก์ชำระเงินผ่านตัวแปรในบอท

การเรียกกลับหลังจากชำระเงินสำเร็จ:

2. การแสดงลิงก์ในปุ่ม

การดำเนินการบล็อก:

การเรียกกลับหลังจากชำระเงินสำเร็จ: