Tài liệu

• Ubuntu 22.04+ hoặc Debian 12+; Mint 21+ và Pop!_OS 22+.
• Fedora 42+; Rocky, AlmaLinux, RHEL, Oracle Linux hoặc CentOS Stream 9–10.
• openSUSE Leap 16+ hoặc Tumbleweed; Arch, Manjaro hoặc EndeavourOS.

Chọn bản phát hành còn được nhà cung cấp duy trì. Yêu cầu OS cao hơn được ưu tiên: openSUSE Leap 16 yêu cầu hơn 40 GB dung lượng đĩa.

Nhiều chuỗi và hóa đơn đồng thời hơn có thể cần thêm CPU và RAM. VPS lớn hơn không loại bỏ hạn ngạch RPC. Các luồng thiết lập có kiểm thử tự động; chưa hoàn tất kiểm thử đầy đủ trên VPS mới cho mọi bản phân phối.

Cần một bản phát hành cụ thể? Trên VPS mới, thêm --version 7.8.1 để cài đúng phiên bản có chữ ký đó. Nếu không có, quy trình thiết lập dùng bản ổn định mới nhất.

Tiếp tục giữ nguyên bản phát hành đã chọn và các bước hoàn tất, kể cả khi dùng nguồn dự phòng GitHub. Không bao giờ hạ phiên bản của cài đặt hiện có.

Kiểm tra trình cài đặt. Thêm --check vào lệnh để kiểm tra tương thích mà không cài đặt, hoặc --help để xem tùy chọn.

Tiếp tục tiến trình đã lưu mà không thay khóa hay cài đặt:

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --resume

Các tên miền gốc bổ sung có thể dùng cùng tên dịch vụ. Mọi bản ghi IPv6 cũng phải trỏ đến VPS này. Chỉ bật proxy Cloudflare sau khi xác thực tên miền.

Báo giá mới cho stablecoin được nhận diện được làm tròn lên: 1.321 USDC → 1.33 USDC, ngay cả khi dung sai bằng 0. Tối thiểu: 0.01 token.

Hóa đơn, số dư và phần còn lại của thanh toán từng phần hiện có giữ nguyên độ chính xác. Token khác/tùy chỉnh giữ độ chính xác thông thường.

Thông tin đăng nhập Basic Auth của bạn được lưu trong /root/whollycrypto/config/setup-credentials.txt. Thông tin này tách biệt với email/mật khẩu bảng điều khiển.

Dự án mới kế thừa tiền tệ và múi giờ mặc định của hệ thống; cửa hàng dùng tiền tệ của dự án. Múi giờ của tài khoản hiện có được quản lý riêng trong Cài đặt → Tài khoản.

whollycrypto welcome hiển thị URL bảng điều khiển của bạn.

1. Node dùng chung, tỷ giá, tên miền, tín dụng cài đặt và cập nhật nằm trong Bảng điều khiển Operator.
2. Mở Ví → Tạo ví nhận cho BTC, ETH và USDC/USDT Ethereum. Sao lưu cả hai cụm từ khôi phục độc lập. Dự án chuyên dụng này không thể phát hành hóa đơn bán hàng; cửa hàng nhận hiện có được giữ lại.
3. Thêm nhà bán hàng với tiền tệ tín dụng, mức phí và email quản trị viên. Chia sẻ riêng lời mời và Basic Auth dành cho nhà bán hàng. Họ tự chọn mật khẩu. Không bao giờ chia sẻ Basic Auth của Operator.
4. Nhà bán hàng nạp thêm qua trang thanh toán của bạn, hoặc bạn ghi nhận điều chỉnh tín dụng có giải thích. Cần có tín dụng trước khi tạo dự án/cửa hàng. Quản lý người dùng và lịch sử tín dụng trong Nhà bán hàng → Quản lý.

Thiết lập Operator yêu cầu địa chỉ thứ tư, chẳng hạn operator.example.com, cùng tên người dùng và mật khẩu Basic Auth riêng. Chọn nhãn, trỏ DNS đến VPS, kiểm tra DNS và kích hoạt HTTPS. Bảng điều khiển mở trực tiếp tại địa chỉ đó. Địa chỉ nhà bán hàng, trang thanh toán và API của bạn vẫn riêng biệt.

Dùng thông tin đăng nhập Basic Auth mới của Operator, rồi email/mật khẩu quản trị viên. Basic Auth của nhà bán hàng không thay đổi. Thiết lập có thể tiếp tục sau lỗi DNS hoặc chứng chỉ. Operator nâng cấp từ 7.0.0 cũng hoàn tất bước này; địa chỉ đang hoạt động vẫn khả dụng.

Ở mức 3%, hóa đơn 100 EUR dùng 3 EUR tín dụng nhà bán hàng. Nếu tiền tệ tín dụng khác, tỷ giá tiền pháp định tại thời điểm tạo được lưu cùng phí.

Operator trả riêng phí cài đặt Wholly Crypto thông thường. Tiền của khách hàng không bị chia trên chuỗi. Mua tín dụng không bị tính phí lần nữa.

Chỉ quyết toán được xác minh tự động mới ghi có khoản nạp. Mở trang thanh toán hoặc chấp nhận hóa đơn thủ công không làm việc đó. Đảo ngược tạo bút toán sổ cái; khoản nạp đã đảo ngược mà xuất hiện lại cần Operator xem xét.

Tín dụng lưu trữ thấp tạm dừng IPN, webhook, gom tiền và tạo dự án/cửa hàng mới. Hóa đơn khách hàng hiện có và việc nhận tiền vẫn tiếp tục. Tín dụng cài đặt thấp có thể tạm dừng tự động hóa trên các doanh nghiệp được lưu trữ. Vô hiệu hóa nhà bán hàng còn chặn đăng nhập và hóa đơn mới, trong khi các thanh toán cũ vẫn được giám sát.

Đây là cách ly ở cấp ứng dụng, không phải VPS riêng cho mỗi nhà bán hàng. Nhà bán hàng không thể truy cập dự án, ví, thông tin xác thực API, sàn hoặc tín dụng của nhau. Quản trị viên máy chủ có thể truy cập khóa ví nóng được lưu trữ. Hãy thông báo trước khi tiếp nhận nhà bán hàng; dùng dịch vụ lưu trữ đáng tin cậy, bản sao lưu độc lập và tài nguyên phù hợp cho tải dùng chung.

Từ 7.2.0, Ví quản lý số dư nhận, địa chỉ và bản sao lưu; Sweep xử lý gửi tiền và quy tắc tự động. Giữ ETH để trả phí token. Khoản nạp của nhà bán hàng theo dõi các lần mua của họ. Tín dụng ở phần đầu trang trả phí cài đặt riêng. Doanh nghiệp của tôi mở bảng điều khiển riêng của bạn trong tab mới.

Mở Tài chính để xem phí đã thu, phí cài đặt đã xác minh, biên lợi nhuận ước tính và tín dụng nhà bán hàng hiện tại. Lọc theo ngày, nhà bán hàng hoặc tiền tệ báo cáo; xuất CSV.

Báo cáo nhóm hóa đơn theo lần quyết toán đầu tiên và phản ánh các khoản đảo ngược phí mới nhất. Số dư trả trước không phải doanh thu. Phí của doanh nghiệp riêng được tách biệt. Phí đang chờ hoặc thiếu tỷ giá khiến biên lợi nhuận liên quan không khả dụng. Số tiền quy đổi dùng tỷ giá tiền pháp định hiện được lưu đệm; không gồm gas và chi phí vận hành.

Thêm nhà bán hàng tạo lời mời. Từ 7.3.0, chọn tín dụng khởi đầu miễn phí bằng tiền tệ tín dụng của nhà bán hàng; cho phép bằng 0. Việc này không nạp lại số dư Operator của bạn. Gửi lời mời qua email được chọn mặc định.

Cấu hình nhà cung cấp SMTP của bạn trong Cài đặt → Email lời mời trước, dùng TLS hoặc STARTTLS. Kiểm tra kết nối không gửi email. Hoặc bỏ chọn email và chia sẻ liên kết riêng. Email thất bại vẫn giữ tài khoản và tín dụng; không tạo lại nhà bán hàng.

Để lấy liên kết khác hoặc đặt lại mật khẩu, mở Nhà bán hàng → Quản lý → Tài khoản người dùng. SMTP chấp nhận không bảo đảm thư đến hộp thư đến. Chia sẻ Basic Auth nhà bán hàng riêng, không bao giờ chia sẻ thông tin xác thực Operator.

Lời mời có hiệu lực 48 giờ; đặt lại mật khẩu có hiệu lực một giờ. Mỗi liên kết dùng một lần. Thay hoặc thu hồi liên kết từ cùng màn hình. Đặt lại mật khẩu đăng xuất các phiên hiện có nhưng giữ 2FA bật. Vẫn cần Basic Auth của nhà bán hàng.

Tạo tài khoản trực tiếp với mật khẩu hoặc gửi lời mời. Quản lý người dùng, dự án, cửa hàng, phí và tín dụng trả trước cục bộ; đọc báo cáo và đăng ký các sự kiện vòng đời có chữ ký. Sự đồng ý về lưu ký ở lần đăng nhập đầu, 2FA và cách ly tenant vẫn được giữ.

Mọi thao tác ghi cần khóa idempotency đã lưu. Cấp tín dụng là điều chỉnh tài khoản cục bộ, không phải nạp tín dụng cài đặt. Bí mật ví, gửi tiền và cấu hình máy chủ nằm ngoài API này.

Dùng api.your-domain.com/v1/operator. Giữ khóa Operator trên backend, không bao giờ trong trình duyệt hay giao cho nhà bán hàng được lưu trữ.

Cài đặt → Sổ địa chỉ: lưu chuỗi/địa chỉ. Đồng gốc và token CoinGecko khớp tự động xuất hiện. Chỉ đọc, do quản trị viên quản lý; việc chấp nhận thanh toán không thay đổi.

Bộ đọc token bao phủ 22 chuỗi. Số dư riêng tư và các lớp Bitcoin/CashTokens/Kaspa cần quyền truy cập hoặc bộ lập chỉ mục riêng. Đọc thất bại hiển thị lỗi, không phải số 0.

Gom số dư hóa đơn vào ví khác bằng gửi thủ công hoặc gom tiền tự động. Chuyển token cũng cần đồng gốc của chuỗi để trả phí.

Giá không khả dụng liên quan đến tỷ giá, không phải số dư.

1. Cửa hàng → Phương thức thanh toán → EVM hoặc Solana → Token tùy chỉnh.
2. Nhập hợp đồng/mint, tên và mã. Chọn giá USD cố định hoặc giá DEX tự động.

Mạng/số chữ số thập phân được kiểm tra. Giá toàn dự án không thay đổi báo giá hiện có. Chỉ khớp danh mục không tự bật thanh toán.

Định giá tự động

DEX Screener yêu cầu pool khớp chính xác hợp đồng, thanh khoản $10,000 và giao dịch trong vòng một giờ. Tỷ giá làm mới mỗi phút; tỷ giá lỗi hoặc đã cũ năm phút chặn báo giá mới.

Giá DEX có thể bị thao túng; kiểm tra không phải kiểm toán. Dùng token ERC-20 tiêu chuẩn hoặc SPL cổ điển đáng tin cậy. Token-2022/phần mở rộng không được hỗ trợ. Nếu không có pool phù hợp, dùng giá cố định.

Trình quét ngoại tuyến? Hóa đơn giữ các phương thức đã cấu hình trong khi chờ phát hiện. Kiểm tra API được hỗ trợ trong Kết nối chuỗi; hoạt động tốt không có nghĩa là tương thích trình quét. Mặc định: hai nhà cung cấp độc lập.

Vẫn cần ví/tỷ giá. Dịch vụ Monero/Lightning phải phát hành yêu cầu thanh toán.

Lỗi API/MCP gồm error.details.payment_methods. SDK 2.4.0 thêm giải thích an toàn: PHP getPaymentMethodIssues(), Python payment_method_issues, Node paymentMethodIssues. Tham chiếu lỗi →

Báo giá tiền mã hóa làm tròn lên và gồm mức chênh lệch của cửa hàng. Hóa đơn định giá bằng tiền pháp định không chuyển tiền mã hóa nhận được thành số dư ngân hàng.

Không yêu cầu xác nhận sẽ quyết toán ngay khi phát hiện, không có sự bảo vệ của xác nhận mạng. Thanh toán EVM bằng đồng gốc được phát hiện dưới dạng chuyển trực tiếp. Xem xét thanh toán bất thường hoặc chưa chắc chắn trong Cần chú ý.

Bị chặn mặc định. Bật Cửa hàng → Hóa đơn → Cho phép hóa đơn số tiền bằng 0 để cho phép tổng bằng 0 qua thủ công/API. Hóa đơn hoàn tất ngay, không có thanh toán, địa chỉ nhận, giao dịch hay phí xử lý.

status là trạng thái hóa đơn tại thời điểm tạo sự kiện; event_type cho biết điều gì đã xảy ra.

• Ví dụ Ethereum: payment.received + processing, rồi invoice.settled + settled.
• Ví dụ Solana: đã có tính chung cuộc khi được phát hiện, nên payment.received và invoice.settled cả hai đều mang settled.

Một trong hai luồng đều có thể xảy ra trên chuỗi khác. Đây là các sự kiện riêng, không nhất thiết là hai khoản thanh toán. Chúng có thể có cùng sequence nhưng có các giá trị event_id khác nhau. Không bảo đảm thứ tự gửi; đừng yêu cầu processing phải đến trước.

Sự kiện: invoice.created, payment.received, invoice.processing, invoice.settled, invoice.expired, invoice.invalid, invoice.cancelled. Bảng sự kiện đầy đủ và quy tắc ngoại lệ →

amount_status: none, partial, paid, overpaid. paid bao gồm dung sai, không phải tính chung cuộc. timing_status: on_time hoặc late. resolution: automatic, manually_settled hoặc manually_invalidated. Áp dụng chính sách ngoại lệ của bạn khi requires_review là true.

invoice_id khớp với phản hồi API. amount, currency và order_id mô tả đơn hàng ban đầu của bạn. payment_info bổ sung các giao dịch chuyển, số tiền mã hóa chính xác, báo giá/mức chênh lệch/dung sai đã khóa và tỷ giá tham khảo. Dữ liệu khách hàng và metadata là riêng tư.

paid_chain, paid_asset, paid_payment_method_id, paid_asset_amount, paid_asset_amount_received và settlement_exchange_rate tóm tắt quyết toán. Chúng giữ nguyên; bằng chứng/lịch sử thiếu vẫn là null. Với khoản nhận sau đó, dùng payment_info hoặc API thanh toán.

Dùng chuỗi thập phân. Không bao giờ gộp tài sản hoặc coi tiền chưa xác nhận là tiền thiếu. Xử lý ngoại lệ một cách rõ ràng; chỉ cảnh báo không bao giờ cho phép thực hiện đơn hàng hay hoàn tiền. Nạp gas nội bộ đã xác minh không phải thanh toán khách hàng và không kích hoạt payment.received.

Bí mật ký riêng biệt: Cửa hàng → IPN ký các lần gửi IPN, kể cả ipn_urltùy chỉnh của hóa đơn. Mỗi endpoint trong Cửa hàng → Webhook có bí mật riêng, hiển thị khi tạo hoặc thay mới.

Cả hai dùng Wholly-Signature và cùng bộ xác minh SDK, nhưng cần bí mật khớp, không phải khóa API. Thay bí mật IPN không đổi bí mật webhook.

Xác minh nội dung thô, dấu thời gian và phạm vi dự án/cửa hàng. Lưu bền vững, rồi trả HTTP 2xx. Worker kiểm tra hóa đơn hiện tại qua host API đã cấu hình và thực hiện đơn hàng một lần trong giao dịch database. Header không có chữ ký; dùng định danh trong nội dung có chữ ký của phiên bản 2.

Dựa trên sự kiện: loại trùng theo event_idcó chữ ký, rồi lọc invoice.settled. SDK dựa trên trạng thái: gộp theo dự án + invoice_id + sequence, rồi kiểm tra trạng thái bất kể loại sự kiện. Không thêm bộ lọc sự kiện sau bước gộp này. Cả hai đều cần bảo vệ chống trùng riêng ở cấp đơn hàng.

Thử lại giữ nội dung và ID sự kiện ban đầu. Bản sửa đổi cũ không được ghi đè bản mới. IPN thử tối đa tám lần; thử lại webhook là tùy chọn. Tín dụng thấp tạm dừng gửi thông báo, không dừng thanh toán.

Cửa hàng → IPN / Webhook → Lịch sử → Chi tiết hiển thị nội dung đã lưu và kết quả. Payload hết hạn sau 90 ngày. Gửi lại không phải bằng chứng quyết toán.

1. Cài đặt → Sàn giao dịch: kết nối khóa chuyên dụng, kiểm tra số dư và cấp quyền cho dự án. Không cấp quyền rút tiền; giới hạn khóa theo IP VPS của bạn.
2. Dự án → Sweep: xác minh tài sản, mạng, địa chỉ và hợp đồng token. Với mỗi chuỗi/token, chọn ví khác hoặc một sàn.

Thị trường làm mới mỗi hai phút. Chỉ khoản nạp khớp và đã ghi có mới được chuyển đổi; dữ liệu thị trường cũ dừng lệnh mới. Dự phòng 1% tài sản nguồn ở lại sàn để trả phí/làm tròn, tách biệt với tín dụng xử lý.

Giữ số lượng tối thiểu dự trữ coin/token trên toàn dự án sau khi gom tiền tự động. Tách biệt với ngưỡng kích hoạt; bằng 0 thì không giữ lại. Phí dùng phần dư. Gửi thủ công không thay đổi.

Tiếp tục giao dịch chuyển chưa chắc chắn; không bao giờ thay thế. Ví vẫn được giữ chỗ đến khi xác nhận hoặc báo giá chưa dùng hết hạn. Gom tiền lớn cần chia batch.

Áp dụng lưu ký của sàn, KYC, giới hạn khu vực và phí. Không có chi trả ngân hàng hay đòn bẩy. Tín dụng thấp tạm dừng chuyển đổi mới; lệnh đã gửi vẫn được đối soát.

Mở Tự động nạp sau Yêu cầu. Chọn ví nhận đã sao lưu, ngưỡng, số tiền mua, giới hạn hằng ngày và mức trần phí mạng. Cho phép và lưu. Ban đầu tính năng tắt.

Dùng BTC, ETH hoặc USDC/USDT Ethereum khi được cung cấp. Địa chỉ gửi token cần ETH; quy tắc này không cấp gas còn thiếu. Operator dùng ví nhận chuyên dụng; nhà bán hàng được lưu trữ trả cho Operator của họ.

Khoản tự động nạp đã được phê duyệt có thể chạy trong khi tín dụng thấp tạm dừng Sweep. Chỉ dịch vụ nhận xác nhận tín dụng. Mỗi lúc chạy một lần mua tự động. Tắt sẽ dừng công việc chưa gửi, không dừng giao dịch đã gửi.

Trong Tự động nạp, dùng Kiểm tra thanh toán. Tiếp tục cùng khoản thanh toán còn hợp lệ, hoặc đóng giao dịch chuyển Ethereum đã xác minh thất bại và tạm dừng quy tắc. Thanh toán đang chờ hoặc chưa chắc chắn vẫn được giữ để tránh gửi trùng. Báo giá hết hạn không phải bằng chứng thất bại.

Mức mặc định 1% dùng giá trị tiền pháp định ban đầu của hóa đơn đã quyết toán. Thanh toán tiền mã hóa của khách hàng không bị chia.

Phí tiếp tục phát sinh thành số dư âm. Thanh toán phần âm và khôi phục tín dụng dùng được cao hơn ngưỡng gia hạn của tài khoản. Thay đổi số dư thường xuất hiện trong 10–15 giây khi kết nối hoạt động tốt.

Cài cập nhật cần tín dụng trên 0 đã xác minh, ngay cả khi có mức cho phép gia hạn tự động hóa. Nạp thêm không bao giờ tự cài cập nhật.

Thông báo tạm dừng không tiêu tốn lần thử. Các lần gửi được giữ lại sẽ tiếp tục; thời hạn thông thường vẫn áp dụng. Đối soát sự kiện bị bỏ lỡ qua API hóa đơn.

Nếu Operator tắt phí xử lý, không áp dụng phí xử lý mới hay hạn chế tín dụng. Phí trước đó vẫn trong lịch sử. Cài đặt chưa ghép nối có thể cấu hình dự án/cửa hàng, nhưng cần kết nối tính phí đã xác minh để phát hành hóa đơn. Hóa đơn đã phát hành vẫn được giám sát.

• Doanh thu hiển thị giá trị hóa đơn đã quyết toán trước phí/hoàn tiền, theo ngày quyết toán. Đây không phải số dư ví hay lợi nhuận.
• Quy đổi dùng tỷ giá lưu đệm hiện tại, không phải tỷ giá kế toán lịch sử. Tổng theo tiền tệ gốc vẫn có sẵn nếu thiếu tỷ giá.
• Biểu đồ trạng thái hóa đơn dùng ngày tạo hóa đơn. Số liệu Cần chú ý hiển thị vấn đề hiện chưa giải quyết.

• Tiền pháp định cố định: mỗi trang thanh toán mới dùng tỷ giá tiền mã hóa hiện tại và mức chênh lệch của cửa hàng, rồi khóa báo giá đến khi hết hạn.
• Tiền mã hóa cố định: yêu cầu đúng số đơn vị của một tài sản on-chain được chấp nhận. Giá trị tiền pháp định mới, làm tròn lên, được ghi cho báo cáo và phí; không có mức chênh lệch làm đổi số tiền mã hóa.
• Quyên góp: cho khách hàng nhập số tiền trong giới hạn của bạn. Thêm số tiền chọn nhanh và trường tên/email tùy chọn.
• Điểm bán: nhập số tiền hoặc tham chiếu đơn hàng và hiển thị QR thanh toán. Chờ settled, không chỉ phát hiện thanh toán.
• Yêu cầu theo lịch: gửi một lần, hằng tuần hoặc hằng tháng theo múi giờ bạn chọn. Khách hàng tự trả từng hóa đơn. Không tự động trừ tiền ví.

Giao diện cửa hàng, xác nhận và callback vẫn áp dụng. Tạm dừng công cụ dừng yêu cầu mới, không dừng thanh toán hiện có. Lịch sử liên kết đến từng hóa đơn. Kỳ bị bỏ lỡ không tạo đợt email dồn dập; gửi lại dùng lại cùng hóa đơn chưa trả, chưa hết hạn.

Trang thanh toán khách hàng, liên kết thanh toán và email theo lịch hỗ trợ tiếng Anh, Đức, Tây Ban Nha, Bồ Đào Nha Brazil, Ý, Nga, Trung giản thể, Pháp, Hàn và Nhật.

Cửa hàng → Hóa đơn → Ngôn ngữ thanh toán đặt giá trị mặc định. Ghi đè cho từng hóa đơn hoặc công cụ thanh toán. Email và lần gửi lại giữ ngôn ngữ hóa đơn. Văn bản của bạn không đổi; bảng điều khiển Merchant và Operator vẫn bằng tiếng Anh.

1. Mở Cài đặt → Thông báo & cảnh báo. Thông báo trong bảng điều khiển được tích hợp sẵn.
2. Với email hoặc Telegram, thêm kênh, gửi mã xác minh và nhập mã. Sau đó bật kênh và chọn kênh trong các quy tắc.
3. Chọn cảnh báo cho ngoại lệ thanh toán, callback thất bại, vấn đề chuyển tiền, gas thấp, quét chậm, tín dụng thấp hoặc sao lưu thất bại. Cảnh báo thanh toán đã quyết toán là tùy chọn.

Vấn đề lặp lại được nhóm. Lịch sử giữ 30 ngày; quyền dự án vẫn áp dụng. Đọc cảnh báo không giải quyết vấn đề. Cảnh báo cho con người không thay thế IPN hay webhook của cửa hàng.

Chỉ mainnet Bitcoin và coin/ERC-20 EVM được hỗ trợ. Khách hàng trả vào ví do dự án kiểm soát trước, không trả trực tiếp cho nhà bán hàng. Giữ đồng gốc chưa bị ràng buộc để trả phí. Gom tiền thông thường loại trừ các địa chỉ nhận được bảo vệ.

Phí xử lý áp dụng một lần cho hóa đơn ban đầu, tách biệt với hoa hồng của bạn. Thanh toán thiếu và khoản nhận chưa chắc chắn cần xem xét. Hoàn tiền sau khi đã chi trả nhà bán hàng cần tiền riêng, không tự động thu hồi.

Thiết lập thanh toán đa nhà bán hàng · Tài liệu tham chiếu API Marketplace

1. Chọn kỳ, tiền tệ báo cáo và múi giờ. Lọc theo dự án hoặc cửa hàng, rồi tìm tham chiếu hóa đơn, đơn hàng, tài sản hoặc giao dịch.
2. Xem tỷ giá, phí còn thiếu và ngoại lệ thanh toán trong Kiểm tra. Chi tiết liên kết về hóa đơn hoặc giao dịch chuyển hiện có.
3. Tải ZIP cho kế toán với bản tóm tắt có thể in và các file CSV chi tiết. Tối đa 10,000 bản ghi mỗi lần tải; dùng kỳ ngắn hơn cho lịch sử lớn.

Khoản nhận đã xác nhận, hoàn tiền và chi phí đã ghi nhận tách biệt với chuyển ví và mua tín dụng trả trước. Tổng hóa đơn chỉ được tính một lần, dù có nhiều khoản thanh toán.

Giá trị lịch sử dùng bằng chứng được giữ lại, không dùng giá hôm nay. Tỷ giá cũ và phí thực tế có thể không có; không bao giờ giả định chi phí thiếu bằng 0. Bằng chứng chưa đầy đủ khiến tổng ròng không khả dụng.

Nội dung này bao gồm bản ghi được Wholly Crypto theo dõi, không phải mọi giao dịch ví hay sàn bên ngoài. Đây là công cụ hỗ trợ ghi sổ, không phải tờ khai thuế hay báo cáo lợi nhuận. Chia sẻ bản xuất an toàn: chúng có thể chứa email khách hàng.

Ngoài BTC, EVM, SOL và TRX còn có 18 adapter đồng gốc. Dùng nhà cung cấp có khả năng gửi giao dịch. ZEC chỉ minh bạch; ADA giữ lại output có token; DOT dùng Asset Hub; HBAR cần relay. Đích gửi yêu cầu memo/tag/comment cần ví bên ngoài.

1. Mở Dự án → Ví → tài sản → Gửi. Chọn mục trong sổ địa chỉ hoặc nhập đích nhận. Kiểm tra toàn bộ địa chỉ và mạng.
2. Chọn số lượng chính xác hoặc gom số dư khả dụng, rồi chọn mức phí. Với token được hỗ trợ, Dùng ETH dự án cho gas (hoặc đồng gốc của chuỗi) có thể cấp phần phí còn thiếu từ cùng dự án/chuỗi.
3. Nhấp Chuẩn bị chuyển tiền. Xem nguồn, đích, số lượng, phí tối đa và mọi phần gas được phân bổ. Phê duyệt & gửi cho phép kế hoạch này; chỉ chuẩn bị thì chưa gửi gì.

Cấp gas, xác nhận và gửi token tiếp tục chạy nền sau khi phê duyệt. Theo dõi Hoạt động chuyển tiền, kể cả sau khi đóng cửa sổ. Phát giao dịch không phải xác nhận.

Giữ ETH trong ví dự án: 0 không thêm dự phòng; không có nghĩa là tiêu hết ETH của bạn. 0.005 giữ ít nhất 0.005 ETH cho sau này, nên bạn cần thêm tiền cho quy trình này. Quy tắc tự động đã lưu không thay đổi.

1. Mở Thiết lập gom tiền tự động → tài sản → Thiết lập. Chọn địa chỉ ví hoặc đích sàn giao dịchđược hỗ trợ, không chọn cả hai.
2. Đặt mức gom tiền tối thiểu và Giữ số lượng tối thiểu. Ví dụ: kích hoạt ở 100 USDC, giữ 20 USDC, gửi tối đa 80 USDC. Dự phòng áp dụng toàn dự án, không phải từng địa chỉ.
3. Với token, xem xét Dùng ETH dự án cho gas và nhập Giới hạn cấp vốn hằng ngày. Bật Tự động gom tiền, rồi Lưu quy tắc và xác nhận. Chỉ mở Thiết lập không bật gì cả.

Giới hạn hằng ngày chặn mức gas bằng đồng gốc được phân bổ cho mỗi quy tắc token trong cửa sổ 24 giờ trượt. €1 có thể là giới hạn khởi đầu cho sử dụng nhẹ, không phải chi phí bảo đảm hay phí hằng ngày. Giao dịch cấp vốn cũng có phí. % phí mạng tối đa có thể giới hạn tổng phí cấp vốn/chuyển tiền.

Kiểm tra chạy tự động. Chỉ địa chỉ giữ token đủ điều kiện mới nhận gas; địa chỉ trống không nhận. Địa chỉ thiếu vốn có số dư dưới mức gom tối thiểu sẽ chờ. Giải thích giới hạn gas →

• Sao lưu ví và thử chuyển khoản nhỏ. Gửi token trước khi rút hết đồng gốc. ETH ở nơi khác trong dự án phải đến từng địa chỉ token trước; gas chưa dùng ở lại ví của bạn.
• Dùng số dư mới, nhà cung cấp hoạt động tốt và đủ đồng gốc. Quy tắc tự động cần ví đang hoạt động, đã sao lưu và tài sản được bật trong cửa hàng đang bật. Khi tín dụng xử lý thấp, việc gửi có thể tạm dừng.
• Trong Hoạt động chuyển tiền, xem tiến trình, Cấp gas và liên kết explorer. Với kết quả chưa chắc chắn, làm mới cùng giao dịch chuyển; không tạo giao dịch thay thế. Chỉ tiếp tục sau khi xem lý do và giới hạn.

Gửi tiền bị tắt? Kiểm tra whollycrypto transfers status. Xem mọi quy tắc đang bật trước khi whollycrypto transfers enable: thao tác áp dụng toàn máy chủ và có thể chạy ngay các quy tắc đã lưu. Dừng bước tương lai không thể đảo ngược giao dịch đã phát.

Cửa hàng → Cơ bản: chọn host merchant/pay/API đang hoạt động. Liên kết ưu tiên cửa hàng → cửa hàng mặc định → hệ thống; tên đã ngừng dùng chuyển sang nguồn dự phòng. Cấu hình host SDK riêng. Lần thử lại có chữ ký giữ liên kết ban đầu.

• Dùng Full (strict), không dùng Flexible; không cần khóa API.
• Tắt lưu đệm và thử thách trình duyệt/bot cho bảng điều khiển, trang thanh toán và API.
• Cho phép /.well-known/acme-challenge/ trên cổng 80 mà không chuyển hướng/thử thách để gia hạn.

Kiểm tra truy vấn DNS có thẩm quyền và xác minh origin: trực tiếp hoặc Cloudflare. Khách truy cập có thể lưu đệm DNS cũ.

Lưu/xóa trong bảng điều khiển dùng POST từ 5.6.2; không cần ngoại lệ “Not GET or POST”. Đăng nhập và CSRF vẫn hoạt động. Trên api.*, cho phép các phương thức được tài liệu API công khai quy định.

Thay mã hoặc tắt 2FA cần mật khẩu và mã từ ứng dụng xác thực hoặc mã khôi phục chưa dùng. Các phiên khác bị đăng xuất. Đồng bộ đồng hồ điện thoại/máy chủ; 2FA không bảo vệ máy chủ đã bị xâm nhập.

Biểu tượng giao diện chuyển lần lượt Sáng → Dịu → Tối và ghi nhớ lựa chọn của trình duyệt này. Giao diện thanh toán cửa hàng là riêng biệt.

Có thể thêm quy tắc truy cập Cloudflare. Miễn thử thách gia hạn HTTPS; tránh thử thách đăng nhập tương tác trên API và trang thanh toán. Chỉ bật proxy không phải hạn chế IP.

Bị khóa truy cập? Chạy whollycrypto access-reset --domain merchant.example.com qua SSH. Chỉ hostname đó mở lại trong vòng năm giây; xác thực tài khoản vẫn bật.

Chạy whollycrypto ssl --domain merchant.example.com --reissue để buộc thay thế. Áp dụng giới hạn cấp chứng chỉ. Nếu Cloudflare chặn thử thách HTTP, tạm dùng DNS-only. Ví, xác thực và tên miền không thay đổi.

Trình cập nhật cũ bị chặn? Chạy lệnh này một lần. Khóa đã cài xác minh công cụ hỗ trợ.

bash <(curl -fsSL https://releases.whollycrypto.com/update_wholly.sh)

Thiết lập và cập nhật tự động thử mirror GitHub chính thức. Vẫn phải kiểm tra chữ ký, checksum và tín dụng.

Kiểm tra chỉ đọc, trả mã thoát khác 0 khi cần chú ý. --fix chỉ sửa quyền được quản lý và liên kết CLI bị thiếu. Không bao giờ thay đổi tính phí, xóa dữ liệu hay khởi động lại dịch vụ.

whollycrypto reset
# Preview without changing anything:
whollycrypto reset --scope business --check
whollycrypto reset --scope project --project YOUR_PROJECT_IDENTIFIER --check

Chọn một dự án, tất cả dự án kinh doanh hoặc chỉ sửa chữa. Đặt lại dự án xóa vĩnh viễn các dự án đã chọn, cửa hàng, bản ghi ví và lịch sử thanh toán. Chỉ sửa chữa kiểm tra và sửa quyền được quản lý cùng liên kết CLI.

Trước tiên tắt các dự án đã chọn, giải quyết thanh toán/giao dịch chuyển đang mở và chuyển số dư ví đã biết. Tài khoản, tên miền, node, tín dụng, định danh tính phí và chế độ cài đặt được giữ lại. Ví nhận Operator và bản ghi tín dụng lưu trữ được bảo vệ. Thao tác này không mở lại trình hướng dẫn thiết lập.

Đặt lại mang tính phá hủy cần xác nhận bằng cách nhập và tạo bản sao lưu khôi phục đã xác minh trước khi xóa. Cũng giữ bản sao lưu ví ngoài máy chủ: địa chỉ cũ vẫn có thể nhận tiền, nhưng dự án bị xóa ngừng theo dõi chúng. Số dư lưu đệm không chứng minh ví trống.

whollycrypto uninstall --check
whollycrypto uninstall

Dừng trang thanh toán, API và worker; gỡ file runtime cùng tích hợp máy chủ được quản lý sau khi sao lưu và xác nhận bằng cách nhập. Thanh toán hoặc giao dịch chuyển đang chờ chặn việc gỡ. File được chuyển vào bản sao lưu khôi phục thay vì bị xóa sạch.

Database, cấu hình, khóa và sao lưu được giữ lại. Gói Nginx/PostgreSQL dùng chung và chứng chỉ TLS không bị đụng tới. Lệnh in ra lệnh khôi phục offline; không chạy thiết lập mới đè lên dữ liệu được giữ lại.

Lệnh đặt lại/gỡ dành cho cài đặt VPS native, không phải Docker hay Umbrel. Với container, dùng lệnh sao lưu và dừng của tích hợp; giữ các volume. Cả hai lệnh phá hủy đều không chấp nhận --yes.

whollycrypto htaccess

Chọn người dùng, chọn tên/mật khẩu và xác nhận. Thao tác đặt lại lời nhắc đăng nhập đầu tiên của trình duyệt, không phải tài khoản bảng điều khiển. Người dùng khác và thông tin xác thực API không đổi.

whollycrypto admin-reset

Chọn quản trị viên theo email và xác nhận mật khẩu mới. Phiên và khóa đăng nhập tài khoản được xóa; hạn chế IP vẫn còn.

Đặt lại thông thường giữ 2FA. Nếu mất cả ứng dụng xác thực và mã khôi phục, hãy chủ động chạy whollycrypto admin-reset --email admin@example.com --reset-2fa. Thiết lập lại 2FA sau khi đăng nhập.

Cần database, không cần ứng dụng hay mật khẩu cũ. Tài khoản khác, ví và quyền không đổi; tài khoản bị tắt vẫn tắt.

Mất cả ứng dụng xác thực và mã khôi phục? Chọn tài khoản với quyền root.

whollycrypto 2fa-reset
# Or select the account directly:
whollycrypto 2fa-reset --email user@example.com

Xóa phiên, ứng dụng xác thực và mã khôi phục. Đăng nhập bằng mật khẩu hiện có và cấu hình lại 2FA. Quyền, ví và Basic Auth không đổi; tài khoản bị tắt vẫn tắt.

Cần database, không cần ứng dụng hay tín dụng. Không tương tác: --email và --yes.

Nhấn Enter tạo mật khẩu trong /root/whollycrypto/config/credential-resets/: riêng tư, không mã hóa, dùng được sau khi thành công. Mật khẩu nhập thủ công không được lưu.

whollycrypto htaccess --user admin --new-user operator
whollycrypto admin-reset --email admin@example.com

Không có terminal thì chỉ định tài khoản hiện có cùng --generate hoặc --password-file /root/private-password.txt, và --yes. File mật khẩu phải thuộc sở hữu root, có quyền 600. Không bao giờ đưa mật khẩu vào lệnh hay biến môi trường.

--yes chỉ bỏ qua xác nhận. Hoàn tất khôi phục cập nhật bị gián đoạn trước; thay đổi tài khoản đồng thời sẽ dừng đặt lại.