Cách thêm thanh toán crypto vào cửa hàng online

Quyết định trước

Bốn quyết định giúp tránh làm lại về sau.

1. Tài sản và mạng nào. Bắt đầu nhỏ: USDT và USDC bao phủ phần lớn khách. Qvard hỗ trợ USDT, USDC, BTC, LTC, TRX, BNB và ETH, trên các mạng TRC20, ERC20, BEP20, Bitcoin và Litecoin.
2. Giá bằng đô la. Giữ nguyên giá của bạn. Khoản thanh toán được tạo bằng đô la Mỹ và số crypto chính xác hiển thị trên trang thanh toán, với tỷ giá cố định một giờ.
3. Đơn đã thanh toán kích hoạt điều gì. Giao hàng, khóa giấy phép, quyền truy cập nội dung. Quyết định điều gì xảy ra ngay khi khoản thanh toán hoàn tất.
4. Bạn làm gì khi có sự cố. Thanh toán thiếu, hoàn tiền, khách trả nhầm mạng. Viết quy tắc ngay bây giờ.

Các bước tích hợp

Qvard chưa có plugin cửa hàng dựng sẵn, nên cửa hàng tích hợp qua API. Đó là hai đoạn mã phía máy chủ.

1. Tạo khoản thanh toán khi khách chọn crypto. Một POST tới https://api.qvard.com/api/v1/payment với số đơn của bạn làm id và tổng đơn bằng đô la Mỹ làm price, xác thực bằng khóa API của bạn. Phản hồi chứa redirectUrl; hãy chuyển khách tới đó.
2. Nhận kết quả. Lưu một URL callback trong bảng điều khiển. Khi khoản thanh toán hoàn tất, Qvard gửi một POST kèm số đơn và trạng thái. Đánh dấu đơn đã thanh toán và kích hoạt việc thực hiện. Trả lời đúng HTTP 200.
3. Làm cho bộ xử lý an toàn. Nó có thể được giao nhiều hơn một lần, nên lần lặp không được thay đổi gì.

Các phiên bản chi tiết: cách chấp nhận thanh toán crypto trên website cho quy trình chung, WordPress và WooCommerce cho các nền tảng đó, và API thanh toán crypto cho nhà phát triển làm tài liệu tham khảo.

Ánh xạ trạng thái sang trạng thái đơn hàng

Một khoản thanh toán có bốn trạng thái: wait, partial, completed và rejected. Đơn hàng của bạn cần các trạng thái tương ứng, và webhook chỉ đến với completed.

• Đơn đã tạo và chưa thanh toán ứng với wait.
• Thanh toán thiếu ứng với partial: giữ đơn ở trạng thái chờ và yêu cầu khách bù phần chênh lệch.
• Đơn đã thanh toán ứng với completed: thực hiện đơn.
• rejected: coi khoản thanh toán là thất bại và cho khách thử lại.

Bản ánh xạ đầy đủ, kèm mã, nằm trong thanh toán crypto cho thương mại điện tử.

Nội dung ở checkout

Phần lớn yêu cầu hỗ trợ về crypto đến từ nội dung không rõ ràng. Ở bước thanh toán:

• nêu các coin và mạng được chấp nhận;
• nói rằng số tiền phải được gửi đủ và qua mạng hiển thị trên trang thanh toán;
• nêu rằng tỷ giá được cố định một giờ;
• giải thích cách hoàn tiền hoạt động và nơi nhận trợ giúp.

Qvard chưa có URL quay lại, nên khách đến trang thanh toán và bạn là người cho họ biết điều gì xảy ra tiếp theo. Một trang đơn hàng rõ ràng cập nhật sau webhook, cộng với email xác nhận, thay thế cho việc chuyển hướng.

Kiểm thử và đưa vào hoạt động

Chưa có sandbox, nên hãy kiểm thử bằng số tiền thật nhỏ.

1. Trả một khoản tiền thật nhỏ và theo dõi cả hành trình: thanh toán được tạo, khách đã trả, webhook nhận được, đơn được đánh dấu đã thanh toán.
2. Cho endpoint lỗi một lần và xác nhận lần thử lại (năm lần trong khoảng sáu phút) không thực hiện đơn hai lần.
3. Rút một khoản nhỏ về ví của bạn để kiểm tra bước đó. Chỉ tốn phí mạng.
4. Thêm crypto vào checkout và theo dõi những đơn đầu tiên.

Sau khi ra mắt, hãy duy trì một thói quen ngắn; danh sách nằm trong danh sách kiểm tra vận hành cho thanh toán crypto. Chi phí: không có phí thuê bao, và hoa hồng, được xác định riêng cho dự án của bạn, bắt đầu từ 1% và có thể giảm xuống 0,1% theo trang bảng giá.

FAQ