Stablecoin trong trang thanh toán BTCPay của bạn.

Cài đặt

1. Tải xuống BTCPayServer.Plugins.WhollyCrypto.btcpay và đối chiếu với SHA256SUMScủa bản phát hành. Dùng file plugin, không dùng ZIP mã nguồn của GitHub.
2. Với quyền quản trị BTCPay, mở Quản lý plugin → Tải plugin lên, tải file lên và khởi động lại BTCPay.
3. Chọn cửa hàng → Plugin → Wholly Crypto. Chỉ cài đặt không kết nối cửa hàng.

Cập nhật dùng cùng quy trình tải lên. Cập nhật phần mềm merchant Wholly không cập nhật plugin BTCPay.

Kết nối cửa hàng

1. Trong Wholly, tạo dự án/cửa hàng đang bật với phương thức được chấp nhận, ví đã sao lưu, tỷ giá và xác nhận. Dùng cài đặt merchant hiện hành; bộ kết nối này hướng đến API 6.4.5.
2. Sao chép UUID dự án/cửa hàng từ Cửa hàng → Cơ bản → ID API. Tạo thông tin xác thực API đọc/ghi giới hạn theo dự án. Bật Cửa hàng → IPN và sao chép bí mật ký của nó, không phải bí mật webhook.
3. Trong cài đặt Wholly của BTCPay, nhập các giá trị đó cùng origin API và trang thanh toán, chẳng hạn https://api.example.com và https://pay.example.com. Dùng HTTPS công khai trên cổng 443; không có path.
4. Bật Cung cấp Wholly Crypto tại trang thanh toán, lưu, rồi Thử quyền đọc. Có thể chọn tập con của các phương thức cửa hàng chấp nhận.

Cho phép callback HTTPS từ máy chủ Wholly đến BTCPay qua cả hai tường lửa. Plugin cung cấp URL callback. Không áp dụng đăng nhập trình duyệt, CAPTCHA hay Basic Auth trên tuyến đó; phải giữ kiểm tra chữ ký bật.

Trang thanh toán nhúng

Thanh toán toàn trang là mặc định, đặc biệt hữu ích cho ứng dụng ví di động. Với iframe:

1. Trong Wholly, tại Cửa hàng → Nâng cao, bật Cho phép nhúng trang thanh toán. Thêm chính xác origin HTTPS BTCPay của bạn vào Origin HTTPS được phép, không có path hay ký tự đại diện.
2. Trong cài đặt plugin BTCPay, chọn Thanh toán khách hàng → Thanh toán nhúng (iframe) và lưu.
3. Thử hóa đơn mới. Hóa đơn hiện có giữ chế độ hiển thị ban đầu. Mở trang thanh toán đầy đủ vẫn khả dụng cho cùng hóa đơn nếu khung không tải được.

Thông điệp trình duyệt và liên kết quay lại chỉ để điều hướng, không bao giờ là bằng chứng thanh toán.

Kiểm tra luồng thanh toán

Tạo hóa đơn tiền pháp định nhỏ, dương trong cửa hàng thử nghiệm. Chọn Stablecoin & tiền mã hóa · Wholly. Xác minh trang thanh toán, IPN có chữ ký và xác minh API cho đến khi xác nhận. Chỉ thực hiện đơn hàng từ hóa đơn BTCPay đã quyết toán, một lần cho mỗi đơn.

Thử quyền đọc không kiểm tra việc tạo hóa đơn hay IPN. Dùng Kết nối và Thanh toán liên kết để xem lỗi an toàn, tham chiếu đơn hàng và kiểm tra thanh toán.