Tài liệu

blockwallets giúp bạn nhận USDT và USDC, cùng BTC, LTC và các coin gốc (ghi có theo đô la Mỹ với tỷ giá đã chốt). Mọi cách tích hợp bên dưới đều tạo cùng một loại hóa đơn trên cùng một trang thanh toán, với cùng số xác nhận, phí và số dư; chúng chỉ khác nhau ở cách hệ thống của bạn giao tiếp với chúng tôi. Hãy chọn cách phù hợp rồi làm theo trang hướng dẫn của nó.

Chọn cách tích hợp

Được nhóm theo điểm xuất phát của bạn. Mỗi thẻ mở ra hướng dẫn đầy đủ.

Không cần code

Nhận tiền từ trang quản trị người bán; không cần cài gì.

Tích hợp API mới

Bạn tự viết phần tích hợp từ đầu.

Chuyển từ cổng thanh toán khác

Giữ nguyên code: API tương thích, bạn chỉ đổi URL gốc và khóa.

Để AI tích hợp giúp

Dành cho người không viết code nhưng dùng công cụ lập trình AI.

Công cụ

Hỗ trợ gỡ lỗi chạy ngay trong trình duyệt của bạn.

Tương thích Cryptomus hay API gốc?

Cả hai đều tạo cùng một loại hóa đơn trên cùng trang thanh toán, với cùng phí và số dư. Khác biệt nằm ở kiểu yêu cầu, định dạng webhook và cách bạn nhận thông tin xác thực.

Mới bắt đầu? Hãy dùng REST API gốc: số tiền tính bằng cent, ref idempotent, chữ ký webhook có dấu thời gian, và khóa bạn tự tạo trong trang quản trị. Đã dùng Cryptomus, hoặc muốn dùng SDK hay plugin Cryptomus có sẵn? Hãy dùng API tương thích Cryptomus.

Bắt đầu nhanh

Từ con số không đến một khoản thanh toán thử trong năm bước (API tương thích Cryptomus; các API khác làm theo cùng các bước với thông tin xác thực riêng).

1. Đăng ký dùng ở trang chủ. Sau khi được duyệt, đăng nhập vào trang quản trị người bán.
2. Mở “Nhà phát triển › Tích hợp & khóa” trong trang quản trị, tạo merchant và API key ở cột Test rồi thêm các tên miền website của bạn.
3. Máy chủ của bạn tạo hóa đơn bằng POST /v1/payment và chuyển hướng khách đến result.url.
4. Thanh toán bằng “Mô phỏng thanh toán” trên trang thanh toán, rồi kiểm tra trình xử lý webhook của bạn xác minh sign và ghi có theo payment_amount_usd.
5. Chuyển sang thông tin xác thực ở cột Live và trả thử một khoản nhỏ thật một lần (“Thử thanh toán” ở trang chủ của trang quản trị).

POST https://blockwallets.io/v1/payment
merchant: <merchant>
sign: md5(base64(body) + API key)
Content-Type: application/json

{
  "amount": "42.00",
  "currency": "USD",
  "order_id": "order_1042",
  "url_callback": "https://shop.example/webhooks/crypto",
  "url_return": "https://shop.example/cart",
  "url_success": "https://shop.example/thanks?order=1042"
}

Code Node.js, PHP và Python cho từng bước có trong tài liệu API tương thích Cryptomus; nếu muốn nhờ AI làm, hãy bắt đầu với trình tạo prompt.

Liên kết thanh toán (không cần code)

Trang quản trị → “Thanh toán › Liên kết thanh toán” → nhập mô tả và số tiền (cố định mạng hoặc để khách chọn) → tạo. Mỗi liên kết có một URL và một mã QR.

• Mỗi lần có người mở liên kết, một hóa đơn mới được tạo, nên một liên kết dùng lại được (ví dụ “Hội viên $99”).
• Mọi khoản thanh toán đều hiện trong “Thanh toán › Giao dịch”; rút về ví của bạn từ “Tiền › Số dư & rút tiền”.
• Nếu bạn đã tạo thông tin xác thực và URL webhook tại “Nhà phát triển › Tích hợp & khóa”, các khoản thanh toán qua liên kết cũng được thông báo, theo định dạng webhook tương thích Cryptomus.
• Muốn ngừng nhận, bấm “Tắt” và liên kết ngừng hoạt động ngay lập tức.

POS cho cửa hàng

Dành cho quầy và gian hàng: trang quản trị người bán → “Thanh toán › Thu ngân POS” → mở một thiết bị đầu cuối và lấy liên kết POS. Nhân viên mở nó trên điện thoại hoặc máy tính bảng, nhập số tiền và mã QR thanh toán sẽ hiện ra; khi khách thanh toán, màn hình hiển thị “Paid”.

• Hóa đơn POS có hiệu lực 30 phút. Tiền vào số dư của bạn và hiện trong “Thanh toán › Giao dịch”, đồng thời bạn được thông báo tại URL webhook giống như liên kết thanh toán.
• Liên kết POS chỉ nhận được thanh toán: nó không xem được số dư, các lệnh rút, đơn hàng khác, cài đặt hay thông tin xác thực của bạn.
• Mất thiết bị, hoặc nhân viên đã nghỉ? Hãy thu hồi thiết bị đầu cuối đó trong trang quản trị và liên kết của nó ngừng hoạt động ngay lập tức.

Nút nhúng

Trang quản trị người bán → “Thanh toán › Liên kết thanh toán” → “Nút nhúng”: chọn chữ, màu, kích thước và hình dạng rồi sao chép đoạn mã. Nhấp vào nút sẽ mở trang thanh toán của liên kết thanh toán đó.

• HTML thuần: một liên kết đã tạo kiểu, không có script, nên dùng được ở bất cứ đâu cho phép dán HTML (trình tạo website, diễn đàn, chữ ký email).
• Kèm script: thêm data-blockwallets và một thẻ /embed.js; trên máy tính, trang thanh toán mở trong một cửa sổ nhỏ ở giữa màn hình, trên điện thoại thì mở bình thường.
• Script không gửi yêu cầu nào, không đặt cookie và không thêm iframe. Nếu trang chặn nó, nút vẫn là một liên kết bình thường và vẫn hoạt động.

Trong các đoạn mã bên dưới, hãy thay /l/pl_… bằng địa chỉ liên kết thanh toán của chính bạn.

HTML thuần

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   style="display:inline-flex;align-items:center;height:44px;padding:0 22px;border-radius:999px;background:#1f5a3d;color:#ffffff;font:600 16px/1 sans-serif;text-decoration:none">Pay with crypto</a>

HTML + script

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   data-blockwallets data-color="green" data-size="m" data-shape="pill">Pay with crypto</a>
<script src="https://blockwallets.io/embed.js" async></script>