Nhận thanh toán crypto trong cửa hàng trực tuyến, không cần plugin

Tóm tắt nhanh

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

Từ lúc khách hàng chọn “Thanh toán bằng crypto” đến khi đơn hàng rời kho của bạn:

1. 1

   Tạo hóa đơn khi thanh toán

   Khi khách hàng chọn crypto, máy chủ của bạn gọi POST /invoices với tổng tiền đơn hàng, order_id của bạn, email của khách hàng, một redirect_url trỏ về trang cảm ơn của bạn và bất kỳ metadata nào bạn muốn được trả lại nguyên vẹn. Phản hồi là hóa đơn kèm một checkout_url.

2. 2

   Đưa khách hàng đến trang hóa đơn

   Chuyển hướng đến checkout_url. Trang này liệt kê các coin bạn chấp nhận; khi khách hàng chọn một coin, số tiền bằng coin đó được tính từ giá trực tiếp và được chốt, và một địa chỉ nạp được tạo riêng cho hóa đơn này hiển thị kèm mã QR. Hóa đơn giữ mở trong khoảng thời gian bạn đặt, mặc định là 30 phút.

3. 3

   Nhận các webhook có chữ ký

   Endpoint của bạn nhận invoice.confirming khi khoản thanh toán được thấy trên chuỗi và invoice.paid khi nó đã đủ xác nhận. Xác minh header CM-Signature, lưu sự kiện, trả về 2xx trong vòng 10 giây, rồi mở khóa đơn hàng từ bản đã lưu của bạn. Sự kiện có thể đến hai lần: dùng id của sự kiện để chỉ giao hàng một lần.

4. 4

   Xử lý ba trường hợp đặc biệt

   invoice.expired: không có khoản thanh toán nào đến kịp, hãy cung cấp một hóa đơn mới. invoice.underpaid: khách hàng có thể gửi phần còn thiếu đến cùng địa chỉ hoặc nhận hoàn tiền từ trang hóa đơn. Hóa đơn trả thừa vẫn là đã thanh toán; phần thừa được giữ cho khách hàng, và họ có thể rút từ trang hóa đơn.

5. 5

   Nhận chi trả

   Các khoản thanh toán đã xác nhận được cộng vào số dư của bạn sau khi trừ 1% và được gom vào ví pool của doanh nghiệp bạn. Chi trả bất cứ lúc nào về địa chỉ riêng của bạn, mỗi coin giữ nguyên hoặc hoán đổi toàn bộ sang một coin nắm giữ.

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": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

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ó plugin cho cửa hàng. Không có module WooCommerce, Shopify, Magento, PrestaShop hay OpenCart. Bạn tự thêm lời gọi API, hoặc chia sẻ trang thanh toán và liên kết thanh toán của mình.
• Không hoàn tiền tự động và không có lệnh gọi hoàn tiền trong API. Một khoản thanh toán crypto đã xác nhận là cuối cùng, nên hoàn tiền là một lần chuyển mới. Khi khách trả hàng, Quản trị viên tạo một liên kết hoàn tiền riêng tư từ khoản đã thanh toán trong cổng quản lý; khách hàng tự nhập địa chỉ của họ, phí mạng được trừ vào khoản hoàn tiền và phí 1% không được hoàn lại.
• Lưu ký, chỉ dùng crypto. Crypto Merchant giữ khóa cho đến khi bạn chi trả, và các khoản chi trả đi về địa chỉ ví riêng của bạn, không về tài khoản ngân hàng.

Phù hợp với ai?

• Cửa hàng đã vận hành trang thanh toán riêng và có thể thêm một lời gọi API cùng một webhook.
• Cửa hàng bán cho khách hàng ở những nước khó có thẻ hoặc nơi chargeback gây thiệt hại.
• Cửa hàng định giá bằng đô la và muốn quyết toán bằng USDT hoặc USDC.

Trang liên quan

• Nhận tiền điện tử trên Shopify không cần plugin
• Nhận tiền điện tử trên WooCommerce không cần plugin
• Tài liệu tham khảo API
• Webhook
• Thanh toán thiếu và thanh toán thừa
• Các cổng thanh toán crypto tốt nhất
• Bảng giá và phí

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

• SaaS và thuê bao
• Freelancer
• Sản phẩm số
• Quyên góp

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