Chuyển sang blockwallets
blockwallets có API tương thích với ba cổng thanh toán. Tìm cổng của bạn bên dưới: bảng cho thấy những thứ duy nhất bạn cần đổi.
Những gì bạn cần đổi
| Đang dùng | Trước | Sau | Thông tin xác thực mới | Chữ ký webhook | |
|---|---|---|---|---|---|
| Cryptomus | https://api.cryptomus.com | https://blockwallets.io | merchant + API key | trường sign trong nội dung, md5(base64(…) + API key) | Hướng dẫn đầy đủ → |
| NOWPayments | https://api.nowpayments.io/v1 | https://blockwallets.io/nowpayments/v1 | API key + IPN secret | x-nowpayments-sig (HMAC-SHA512) | Hướng dẫn đầy đủ → |
| Coinbase Commerce | https://api.commerce.coinbase.com | https://blockwallets.io/coinbase/ | API key + webhook shared secret | X-CC-Webhook-Signature (HMAC-SHA256) | Hướng dẫn đầy đủ → |
Ngoài API tương thích Cryptomus, blockwallets còn có API tương thích với NOWPayments và Coinbase Commerce: đường dẫn, header xác thực, trường yêu cầu / phản hồi, trạng thái và chữ ký webhook đều theo tài liệu chính thức của họ, nên code hiện có thường chỉ cần URL gốc và khóa mới. Coinbase Commerce đã ngừng phục vụ người bán ngoài Hoa Kỳ và Singapore từ 2026-03-31 — bạn có thể chuyển sang ngay.
Bên dưới đó là một hóa đơn blockwallets bình thường: địa chỉ nhận tiền là của bạn, trang thanh toán là trang thanh toán do chúng tôi lưu trữ, và một khoản thanh toán chỉ được tính khi đã được xác nhận trên chuỗi và đối chiếu với node thứ hai. Phần dưới gồm: ba bước, rồi từng API hỗ trợ gì và khác bản gốc ở đâu — tham số chúng tôi không triển khai sẽ trả về lỗi chứ không bị bỏ qua âm thầm.
Chế độ thử nghiệm
Charge và thanh toán tạo bằng thông tin xác thực thử nghiệm chạy trên testnet của từng chuỗi và webhook của chúng được ký bằng IPN secret / shared secret thử nghiệm — tách biệt hoàn toàn với live: khóa thử nghiệm không thấy được các khoản thanh toán live.
Mọi thứ còn lại (trang thanh toán, xác nhận, mạng và mức tối thiểu, hoàn tiền) hoạt động như trong tài liệu chính.