Danh sách kiểm tra vận hành cho thanh toán crypto

Trước khi ra mắt

Làm một lần, và làm lại sau mỗi thay đổi trên máy chủ.

• Khóa API chỉ nằm trên máy chủ, trong biến môi trường hoặc trình quản lý bí mật, không bao giờ trong mã front-end hay kho mã.
• URL callback đã lưu, công khai và dùng HTTPS, truy cập được từ bên ngoài mạng của bạn.
• Bộ xử lý webhook trả lời đúng HTTP 200, nhanh, và chạy hai lần vẫn an toàn. Bất kỳ trạng thái nào khác, hết thời gian hay chuyển hướng đều tính là giao thất bại. Xem cách bảo mật webhook thanh toán crypto.
• Thanh toán thử chạy trọn vẹn. Trả một khoản nhỏ thật, thấy webhook đến và đơn chuyển sang đã thanh toán. Chưa có sandbox, nên hãy dùng số tiền thật nhỏ.
• Thử lại hoạt động. Cho endpoint lỗi một lần và xác nhận Qvard thử lại (năm lần trong khoảng sáu phút) mà không thực hiện đơn hai lần.
• Rút tiền hoạt động. Rút một khoản nhỏ về ví của bạn. Chỉ tốn phí mạng.
• Quy tắc đã được viết ra: xử lý khoản thanh toán thiếu thế nào, hoàn tiền ra sao và ai trả lời khách.

Mỗi ngày

Vài phút, tốt nhất vào cùng một giờ.

• Đơn chưa trả quá cửa sổ tỷ giá. Tỷ giá trên trang thanh toán được cố định một giờ. Xem các đơn vẫn chờ sau đó: bị bỏ, hoặc sót một thông báo.
• Thanh toán thiếu. Khoản thanh toán có trạng thái partial không gửi webhook hoàn tất. Kiểm tra trong bảng điều khiển, giữ đơn ở trạng thái chờ và liên hệ khách. Xem cách xử lý thanh toán USDT thiếu.
• Lỗi ở endpoint webhook. Một loạt yêu cầu lỗi hoặc phản hồi 401 nghĩa là endpoint hỏng hoặc khóa không khớp. Đặt cảnh báo thay vì phát hiện vào cuối ngày.
• Tổng theo ngày. So sánh các đơn bạn đánh dấu đã thanh toán với các khoản thanh toán trong bảng điều khiển. API công khai không có route liệt kê thanh toán, nên đây là phép so sánh với nhật ký webhook của chính bạn. Xem đối soát thanh toán cho người bán crypto.

Mỗi tuần

• Thông báo bị sót. Nếu bảng điều khiển hiện một khoản đã hoàn tất mà hệ thống đơn hàng của bạn không có, hãy gửi lại thông báo từ bảng điều khiển và để bộ xử lý idempotent áp dụng.
• Mẫu hình hỗ trợ. Đếm các yêu cầu về nhầm mạng, thanh toán thiếu và «tôi đã trả nhưng không có gì xảy ra». Nếu một loại lặp lại, hãy sửa lời lẽ ở checkout hoặc trang đơn hàng, thay vì xử lý từng yêu cầu.
• Hoàn tiền. Kiểm tra mỗi khoản hoàn đã gửi được ghi vào đơn gốc và đã đi tới địa chỉ và mạng mà khách xác nhận.
• Số dư theo tài sản và mạng. Thanh toán ở các mạng khác nhau tích lũy riêng. Xem cái gì nằm ở đâu trước khi quyết định rút gì.
• Tồn kho và hết hạn. Nếu bạn giữ hàng cho đơn chưa trả, hãy xác nhận đơn hết hạn sẽ nhả hàng ra.

Mỗi tháng

• Đối soát đầy đủ. Khớp đơn hàng trong tháng, nhật ký webhook và các khoản thanh toán trong bảng điều khiển, và giải thích mọi chênh lệch. Ghi doanh thu bằng đô la theo giá trị đơn, còn hoa hồng và phí rút ghi thành dòng riêng.
• Xem lại các lần rút. Không có phí thuê bao; hoa hồng được xác định riêng cho dự án của bạn và theo trang bảng giá, bắt đầu từ 1% và có thể giảm xuống 0,1%. Mỗi lần rút chỉ tốn phí mạng, thường là một khoản cố định cho mỗi giao dịch, nên hãy rút theo mức hợp lý thay vì nhiều lần nhỏ. Xem phí mạng trong vận hành thanh toán crypto.
• Đổi và kiểm tra quyền truy cập. Kiểm tra ai thấy khóa API và bảng điều khiển, và đổi khóa nếu có người từng giữ khóa đã rời đi hoặc bạn nghi bị lộ.
• Đọc lại nội dung dành cho khách. Checkout còn nêu các tài sản và mạng được chấp nhận, ghi chú về phí và quy tắc hoàn tiền không? Còn đúng không?
• Hỏi kế toán của bạn. Việc tính thuế và hạch toán các khoản thu crypto phụ thuộc vào quốc gia của bạn; hãy xem lại thường xuyên.

Khi có điều bất thường

Một kịch bản ngắn cho các trường hợp thường gặp.

• Khách nói đã trả mà đơn chưa thanh toán. Xem khoản thanh toán trong bảng điều khiển. Nếu đã hoàn tất, gửi lại thông báo. Nếu là partial, yêu cầu phần chênh lệch. Nếu không có, hỏi thông tin giao dịch và mạng họ đã dùng.
• Nhầm mạng. Tiền không về như mong đợi và cần xử lý thủ công. Hãy để liên hệ hỗ trợ hiển thị rõ trên luồng thanh toán.
• Đơn đã trả được thực hiện hai lần. Bộ xử lý không idempotent. Làm cho việc cập nhật có điều kiện («đã trả chỉ khi chưa trả») trong một câu lệnh cơ sở dữ liệu.
• Webhook ngừng đến. Thử endpoint từ bên ngoài mạng của bạn, xem mã phản hồi trong nhật ký truy cập và tìm tường lửa, chuyển hướng hoặc bộ xử lý chậm. Xem chiến lược thử lại webhook cho hệ thống thanh toán.
• Bạn không chắc API làm gì. Tài liệu tham khảo là API thanh toán crypto cho nhà phát triển.

Hãy để danh sách này ở nơi cả nhóm nhìn thấy và ghi ai phụ trách từng dòng.

FAQ