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ào | Mộ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àng | Gử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
Tạo hóa đơn khi kỳ kết thúc
Một tác vụ theo lịch gọi
POST /invoicesvới giá gói, mộtorder_idchẳng hạn như id thuê bao cộng với kỳ, email của khách hàng, mộtredirect_urltrỏ về trang thanh toán của bạn, vàmetadataghi tên tài khoản và kỳ. - 2
Cho khách hàng biết nơi thanh toán
Đặt
checkout_urlsau 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
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
metadatathêm một kỳ. Dùngidcủa sự kiện để một lần gửi lặp lại không gia hạn hai lần. - 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
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-walletsvớ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 trongsticky_wallet.reference.
Lời gọi API duy nhất cần dùng
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?
Làm sao tôi biết một khoản thanh toán thuộc tài khoản nào?
Tôi có thể định giá các gói bằng USDT không?
Ví cố định dùng để làm gì?
Trang liên quan
- Tài liệu tham khảo API
- Webhook
- Ví cố định
- Cách thêm nạp tiền điện tử vào tài khoản khách hàng
- Thanh toán tiền điện tử cho nhà phát triển
- Thanh toán stablecoin cho doanh nghiệp
- Bảng giá và phí
Trường hợp sử dụng khác
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.