Trang thanh toán cho ba nhà bán hàng với hoa hồng 4% và chính sách chi trả đã xem xét.
1. Chuẩn bị dự án
Mở Dự án → Marketplace → Cài đặt. Bật Marketplace và chọn các cửa hàng tham gia. Tạm giữ chi trả ở trạng thái dừng. Sao lưu ví dự án và bật Bitcoin hoặc phương thức EVM được hỗ trợ trong từng cửa hàng.
Khách hàng trả vào các ví dự án này trước. Bạn kiểm soát khóa và nợ nhà bán hàng các số dư đã ghi. Giữ riêng đồng gốc tự do để trả phí. Gom tiền thông thường không thể tiêu tiền tại địa chỉ nhận Marketplace.
2. Thêm và phê duyệt ba nhà bán hàng
Trong Nhà bán hàng, thêm từng người bán và địa chỉ Bitcoin mainnet. Xác nhận độc lập địa chỉ với người bán trước khi phê duyệt. Với token EVM, mỗi người bán cũng cần địa chỉ đã phê duyệt trên đúng mạng đó.
Đặt hoa hồng dự án là 4%. Các giá trị ghi đè theo cửa hàng, nhà bán hàng và hóa đơn được ủy quyền được chụp lại, nên chỉnh sửa sau không đổi phân bổ hiện có.
3. Tạo hóa đơn chung
Trong Marketplace → Hóa đơn, tạo hóa đơn 300 USD với ba phần gộp cho nhà bán hàng, mỗi phần 100 USD. Tổng phải khớp chính xác. Gửi liên kết thanh toán cho khách.
Để tích hợp API, dùng khóa Marketplace riêng và gửi chuỗi thập phân đến /v1/marketplace/invoices. Lưu khóa idempotency trước yêu cầu và dùng lại khi hết thời gian chờ. Ví dụ yêu cầu →
4. Xem lại và gửi
Chờ phân bổ đã xác minh trở thành khả dụng. Theo báo giá đã khóa, mỗi người bán nhận lượng tài sản đã trả tương đương 96 USD và bạn giữ hoa hồng tương đương 12 USD. Phí xử lý 1% hiện có, nếu được cấu hình, tốn 3 USD tín dụng trả trước. Phí chuỗi riêng biệt.
Trong Chi trả, chuẩn bị phân bổ khả dụng và giới hạn phí đồng gốc, gas. Bitcoin yêu cầu mọi phần chưa trả của hóa đơn được chọn nằm trong cùng lô. Xem kỹ người nhận và kế hoạch, rồi phê duyệt một lần. Theo dõi đến Đã trả, không chỉ Đã phát.
5. Bật tự động hóa thận trọng
Trong Cài đặt, thêm chính sách cho một tài sản: chi trả tối thiểu, giới hạn tiền gốc mỗi lần và hằng ngày, ngân sách phí đồng gốc và gas, khoảng thời gian và số xác nhận. Chỉ bật sau khi xem các giới hạn và địa chỉ đích đó, rồi bỏ tạm dừng chi trả.
Chính sách tự động có thể gửi mà không cần nhấp thêm. Tín dụng thấp hoặc cổng cho phép chuyển tiền của máy chủ vẫn tạm dừng chi tiêu. Theo dõi và sổ cái vẫn tiếp tục.
6. Xử lý ngoại lệ mà không gửi trùng
- Thanh toán thiếu: dung sai trang thanh toán không tạo số dư nhà bán hàng không có tiền bảo chứng. Chờ trả thêm, hoàn tiền hoặc phê duyệt rõ ràng một phân chia nhỏ hơn có đủ tiền bảo chứng.
- Thiếu gas token: thêm đồng gốc tự do vào ví dự án và xem khoản chi trả được giữ lại. Không tạo khoản chi trả thứ hai để bỏ qua nó.
- Webhook hết thời gian chờ: thử lại cùng sự kiện có chữ ký. Xác minh chữ ký thô và dự án, lưu event_id duy nhất, rồi xác nhận nhận. Sự kiện hóa đơn đã quyết toán không phải hoàn tất chi trả.
- Hoàn tiền sau khi đã trả nhà bán hàng: nạp riêng ví chính, xác minh địa chỉ khách hàng, chuẩn bị hoàn toàn bộ bằng cùng tài sản và phê duyệt. Nhà bán hàng không bị trừ tiền tự động.
- Khôi phục hoặc giao dịch đã phát chưa rõ: giữ chi trả tạm dừng và đối soát các hash giao dịch đã lưu trước khi tiếp tục. Đừng bao giờ mặc định hết thời gian chờ nghĩa là chưa gửi gì.