Chuyển đến nội dung
Crypto Merchant

Trường hợp sử dụng

Nhận thanh toán crypto cho SaaS hoặc dịch vụ thuê bao

SaaS nhận crypto với Crypto Merchant bằng cách tạo một hóa đơn cho mỗi kỳ thanh toán và gia hạn tài khoản khi webhook invoice.paid có chữ ký đến. Ví crypto không thể bị trừ tiền tự động, nên mỗi lần gia hạn là một hóa đơn do khách hàng thanh toán, kèm lời nhắc khi hóa đơn hết hạn. Với tín dụng trả trước, ví cố định cấp cho mỗi khách hàng một địa chỉ nạp cố định, cộng vào số dư của họ khi có deposit.confirmed. Phí là 1% mỗi hóa đơn đã thanh toán, không có phí hằng tháng.

Cập nhật 6 tháng 11, 2026

Mọi nội dung trên trang này mô tả cách Crypto Merchant hoạt động hiện nay, như được nêu trong Tài liệu tham khảo API, tài liệu về trang thanh toán và Bảng giá. Không có gì ở đây là nhận định về các cổng thanh toán khác.

Tóm tắt nhanh

Chủ đềCách hoạt động
Khách hàng thanh toán thế nàoMột trang hóa đơn cho mỗi kỳ thanh toán, liên kết từ màn hình thanh toán của bạn hoặc email gia hạn. Với số dư trả trước, họ có địa chỉ nạp cố định riêng, một địa chỉ cho mỗi mạng.
Bạn cần xây gìMột tác vụ tạo hóa đơn khi một kỳ kết thúc, với metadata ghi tên tài khoản và kỳ, và một endpoint webhook để gia hạn tài khoản. Hoặc POST /sticky-wallets cho mỗi tài khoản.
Thu phí định kỳKhông tự động. Ví crypto không thể bị trừ tiền, nên mỗi lần gia hạn là một hóa đơn mới do khách hàng thanh toán. Sự kiện invoice.expired cho bạn biết khi nào cần gửi lời nhắc.
Định giá và nắm giữĐịnh giá gói bằng đô la hoặc một loại tiền tệ được hỗ trợ khác; stablecoin được tính là một đô la Mỹ mỗi đồng. Hoán đổi toàn bộ những gì nhận được sang USDT hoặc USDC để doanh thu không biến động theo thị trường.
Hồ sơ khách hàngGửi customer_email và các khoản thanh toán được nhóm theo khách hàng trong cổng quản lý; order_id và metadata được trả lại trong mọi webhook.
Giấy tờ để đăng kýKhông có. Bạn không cần công ty đã đăng ký để mở tài khoản; Điều khoản vẫn áp dụng.

Quy trình diễn ra thế nào, từng bước một?

Một gói hằng tháng, từ khi một kỳ kết thúc đến khi kỳ tiếp theo bắt đầu:

  1. 1

    Tạo hóa đơn khi kỳ kết thúc

    Một tác vụ theo lịch gọi POST /invoices với giá gói, một order_id chẳng hạn như id thuê bao cộng với kỳ, email của khách hàng, một redirect_url trỏ về trang thanh toán của bạn, và metadata ghi tên tài khoản và kỳ.

  2. 2

    Cho khách hàng biết nơi thanh toán

    Đặt checkout_url sau nút “Thanh toán bằng crypto” trên trang thanh toán và trong email gia hạn. Khách hàng chọn một coin, tỷ giá được chốt, và hóa đơn giữ mở trong khoảng thời gian bạn đặt, mặc định là 30 phút.

  3. 3

    Gia hạn tài khoản khi có invoice.paid

    Xác minh chữ ký, lưu sự kiện, trả về 2xx, rồi gia hạn tài khoản được ghi trong metadata thêm một kỳ. Dùng id của sự kiện để một lần gửi lặp lại không gia hạn hai lần.

  4. 4

    Nhắc khi có invoice.expired

    Nếu hóa đơn hết hạn mà chưa được thanh toán, hãy tạo một hóa đơn mới và gửi qua email. Hóa đơn hết hạn không giữ lại gì: tỷ giá chỉ được chốt trong lúc hóa đơn còn mở.

  5. 5

    Tín dụng trả trước: cấp cho mỗi khách hàng một địa chỉ cố định

    Với ví cố định, gọi POST /sticky-wallets với id riêng của bạn cho khách hàng sẽ trả về cùng các địa chỉ mỗi lần. Hiển thị chúng trên trang nạp tiền; khi có deposit.confirmed, cộng tiền cho khách hàng được ghi trong sticky_wallet.reference.

Lời gọi API duy nhất cần dùng

Lập hóa đơn cho một kỳ thanh toán
curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "29.00",
    "currency": "USD",
    "order_id": "sub_8f3a-2026-11",
    "description": "Pro plan, November 2026",
    "customer_email": "[email protected]",
    "redirect_url": "https://app.example/billing?paid=1",
    "metadata": { "account": "8f3a", "period": "2026-11" }
  }'

# On "invoice.paid": extend account 8f3a by one month (metadata is echoed back).
# On "invoice.expired": send a reminder with a fresh invoice.

Chi phí là bao nhiêu?

1% trên mỗi hóa đơn đã thanh toán, được trừ khi khoản thanh toán được cộng vào số dư của bạn. Không có phí thiết lập, không có phí hằng tháng và không cần thanh toán để kích hoạt; hóa đơn hết hạn và bị hủy không tốn gì. Việc chuyển coin (gom, hoán đổi và chi trả) có phí gas, được trừ từ số dư gas của bạn nếu bạn đã nạp, nếu không thì trừ từ số coin được chuyển. Khách hàng cũng trả phí gas trên mỗi hóa đơn: phí này được cộng vào số tiền họ gửi, hiển thị trên trang thanh toán và không bao giờ quá 5 US$. Tỷ giá hoán đổi đã bao gồm biên phí dịch vụ 1%. Mọi chi phí nằm trong một bảng duy nhất trên Bảng giá.

Những gì Crypto Merchant không làm ở đây

  • Không có gia hạn tự động. Không có thẻ lưu sẵn để trừ tiền và không có đối tượng thuê bao. Tác vụ của bạn tạo hóa đơn cho mỗi kỳ, và khách hàng thanh toán.
  • Không có công cụ tính thuế hay nhắc nợ. Crypto Merchant tạo hóa đơn, nhận thanh toán và báo cho máy chủ của bạn; VAT, biên nhận và email nhắc nhở là việc bạn tự xây.
  • Lưu ký, chỉ dùng crypto. Số dư nằm trong một ví pool do Crypto Merchant giữ cho đến khi bạn chi trả về địa chỉ riêng của mình. Không có quyết toán qua ngân hàng.

Phù hợp với ai?

  • Công cụ cho nhà phát triển, API và phần mềm bán cho khách hàng ở nhiều nước.
  • Sản phẩm có khách hàng đã nắm giữ stablecoin và thích thanh toán bằng chúng.
  • Nhóm không có công ty đã đăng ký và không thể mở tài khoản người bán truyền thống.

Câu hỏi thường gặp

Crypto Merchant có thể tự động trừ tiền khách hàng của tôi hằng tháng không?
Không. Người bán không thể trừ tiền từ ví crypto. Mỗi lần gia hạn là một hóa đơn do khách hàng thanh toán; bạn tạo nó bằng API khi kỳ kết thúc và nhắc họ nếu hóa đơn hết hạn.
Làm sao tôi biết một khoản thanh toán thuộc tài khoản nào?
Gửi id tài khoản trong order_id hoặc metadata khi bạn tạo hóa đơn. Cả hai được trả lại nguyên vẹn trong đối tượng hóa đơn và trong mọi webhook liên quan.
Tôi có thể định giá các gói bằng USDT không?
Hóa đơn được định giá bằng một loại tiền tệ như đô la Mỹ, và stablecoin được tính là một đô la mỗi đồng, nên gói $29 có giá 29 USDT cộng với phí gas nếu có được hiển thị trên trang thanh toán. Khách hàng vẫn có thể thanh toán bằng bất kỳ coin nào bạn chấp nhận, và bạn có thể hoán đổi toàn bộ những gì nhận được sang USDT hoặc USDC.
Ví cố định dùng để làm gì?
Số dư trả trước. Mỗi khách hàng có các địa chỉ nạp cố định, một địa chỉ cho mỗi mạng, và mỗi khoản nạp đã xác nhận được cộng vào số dư của bạn kèm một webhook ghi tên khách hàng, để bạn cộng tiền đúng tài khoản.

Trường hợp sử dụng khác

Tất cả trường hợp sử dụng

Bắt đầu nhận crypto ngay hôm nay

Thiết lập miễn phí, không cần giấy tờ khi đăng ký, 1% mỗi hóa đơn đã thanh toán và chi trả bất cứ khi nào bạn muốn.