ปลั๊กอิน BTCPAY SERVER

สเตเบิลคอยน์ในหน้าชำระเงิน BTCPay ของคุณ

เพิ่ม Wholly Crypto สำหรับ USDC, USDT และสินทรัพย์อื่นที่ร้านรับ คงวิธี Bitcoin และ Lightning ของ BTCPay เดิมไว้

รับปลั๊กอิน

v1.0.1

BTCPay Server 2.4.4+ และการติดตั้ง Wholly Crypto แยก ทดสอบกับ BTCPay 2.4.4 ให้ทดสอบรุ่นใหม่กว่าบนระบบของคุณ

ดาวน์โหลดปลั๊กอิน ↗GitHub และคู่มือเต็ม ↗

สัญญาอนุญาต MIT · ตัวเชื่อมต่ออิสระ ไม่ใช่การรับรองจาก BTCPay หรือรายการในไดเรกทอรี

หน้าชำระเงินของคุณ ทางเลือกมากขึ้น

หน้าชำระเงินที่โฮสต์หรือ iframe ฝังเป็นทางเลือก
เลือกจากเครือข่ายและสินทรัพย์ที่ร้าน Wholly รับ
IPN ที่ลงลายเซ็นพร้อมตรวจ API แบบยืนยันตัวตน
ค้นหาการชำระเงินที่เชื่อมโยงและวินิจฉัยการเชื่อมต่อ

เงินเข้ากระเป๋าโปรเจกต์ Wholly ตัวเชื่อมต่อไม่ต้องมีคีย์กระเป๋า ใช้กฎเครดิตประมวลผล Wholly ปลั๊กอินไม่เพิ่มค่าธรรมเนียมเปอร์เซ็นต์

ติดตั้ง

ดาวน์โหลด BTCPayServer.Plugins.WhollyCrypto.btcpay แล้วตรวจเทียบกับ SHA256SUMSของรุ่น ใช้ไฟล์ปลั๊กอิน ไม่ใช่ ZIP ซอร์สจาก GitHub
ในฐานะผู้ดูแล BTCPay เปิด จัดการปลั๊กอิน → อัปโหลดปลั๊กอิน อัปโหลดไฟล์แล้วรีสตาร์ต BTCPay
เลือกร้าน → ปลั๊กอิน → Wholly Crypto ติดตั้งอย่างเดียวไม่ได้เชื่อมร้าน

อัปเดตใช้ขั้นตอนอัปโหลดเดียวกัน อัปเดตซอฟต์แวร์ผู้ค้า Wholly ไม่ได้อัปเดตปลั๊กอิน BTCPay

เชื่อมร้าน

ใน Wholly สร้างโปรเจกต์/ร้านที่เปิดใช้งานพร้อมวิธีที่รับ กระเป๋าที่สำรอง อัตรา และการยืนยัน ใช้การติดตั้งผู้ค้าปัจจุบัน ตัวเชื่อมต่อนี้มุ่งรองรับ API 6.4.5
คัดลอก UUID โปรเจกต์/ร้านจาก ร้าน → พื้นฐาน → API ID สร้างข้อมูลรับรอง API อ่าน/เขียนที่จำกัดโปรเจกต์ เปิด ร้าน → IPN แล้วคัดลอกข้อมูลลับลงลายเซ็น ไม่ใช่ข้อมูลลับ webhook
ในการตั้งค่า Wholly ของ BTCPay กรอกค่าเหล่านั้นพร้อม origin ของ API และหน้าชำระเงิน เช่น https://api.example.com และ https://pay.example.com ใช้ HTTPS สาธารณะพอร์ต 443 ไม่มีพาธ
เปิด แสดง Wholly Crypto ที่หน้าชำระเงิน บันทึก แล้ว ทดสอบสิทธิ์อ่าน เลือกเฉพาะบางวิธีที่ร้านรับได้ตามต้องการ

อนุญาต callback HTTPS จากเซิร์ฟเวอร์ Wholly ไป BTCPay ผ่านไฟร์วอลล์ทั้งสอง ปลั๊กอินจัด URL callback ให้ อย่าใช้การล็อกอินเบราว์เซอร์ CAPTCHA หรือ Basic Auth บนเส้นทางนั้น แต่ต้องเปิดตรวจลายเซ็นไว้

หน้าชำระเงินแบบฝัง

หน้าชำระเงินเต็มหน้าเป็นค่าเริ่มต้น เหมาะอย่างยิ่งกับแอปกระเป๋ามือถือ สำหรับ iframe:

ใน Wholly ที่ ร้าน → ขั้นสูง เปิด อนุญาตหน้าชำระเงินแบบฝัง เพิ่ม origin HTTPS ของ BTCPay ที่ตรงทุกตัวใน origin HTTPS ที่อนุญาต โดยไม่มีพาธหรือ wildcard
ในการตั้งค่าปลั๊กอิน BTCPay เลือก หน้าชำระเงินลูกค้า → หน้าชำระเงินแบบฝัง (iframe) แล้วบันทึก
ทดสอบใบแจ้งหนี้ใหม่ ใบเดิมคงโหมดแสดงผลเดิม เปิดหน้าชำระเงินเต็ม ยังใช้ได้กับใบแจ้งหนี้เดียวกันหากเฟรมโหลดไม่ได้

ข้อความเบราว์เซอร์และลิงก์กลับมีไว้เพื่อนำทาง ไม่ใช่หลักฐานการชำระเงิน

ตรวจขั้นตอนชำระเงิน

สร้างใบแจ้งหนี้เงินตราทั่วไปยอดบวกเล็ก ๆ ในร้านทดสอบ เลือก สเตเบิลคอยน์และคริปโต · Wholly ตรวจหน้าชำระเงิน IPN ที่ลงลายเซ็น และการตรวจ API จนยืนยัน ดำเนินคำสั่งซื้อเฉพาะจากใบแจ้งหนี้ BTCPay ที่ชำระเสร็จ ครั้งเดียวต่อคำสั่งซื้อ

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

ข้อจำกัดและปัญหาการส่ง

เฉพาะใบแจ้งหนี้เงินตราทั่วไปยอดบวกคงที่: ทศนิยมสูงสุดแปดตำแหน่ง และเหลือเวลา 5 นาทีถึง 24 ชั่วโมงเมื่อเริ่ม ใบแจ้งหนี้ตั้งราคาคริปโต/เติมยอด การชำระผสมหลายวิธี และคืนเงินอยู่นอกตัวเชื่อมต่อนี้ การจ่ายล่าช้าหรือคลุมเครือต้องตรวจสอบ

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

เครดิตประมวลผลต่ำอาจพัก IPN แม้ลูกค้ายังจ่ายได้ รักษาเครดิตและผู้ให้บริการให้พร้อม กฎเครดิต → · คู่มือ IPN →