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

Cơ bản

Thanh toán

Khách hàng thanh toán trên các trang do Crypto Merchant lưu trữ. Bạn không cần có trang web: chỉ cần chia sẻ trang thanh toán hoặc liên kết thanh toán. Nếu bạn có trang web, hãy tạo hóa đơn bằng API và đưa khách hàng đến trang hóa đơn.

Trang thanh toán của bạn

Mỗi cửa hàng có trang thanh toán riêng tại /pay/<store>, trong đó <store> là tên ngắn của cửa hàng bạn. Khách hàng có thể nhập số tiền ở đó, hoặc chọn một trong các liên kết thanh toán của bạn. Hãy chia sẻ trang này ở bất cứ nơi nào bạn trao đổi với khách hàng: trang web, trang mạng xã hội, cuộc trò chuyện hoặc email.

Bạn sẽ tìm thấy liên kết trong cổng quản lý, mục Trang thanh toán của bạn.

Trang hóa đơn

Mỗi hóa đơn có trang riêng tại /pay/i/<invoice_id>. API trả về liên kết này dưới dạng checkout_url. Trên trang đó, khách hàng:

  • chọn coin và mạng trong số những coin bạn chấp nhận;
  • thấy một địa chỉ nạp được tạo cho hóa đơn này, kèm mã QR, và số tiền chính xác cần gửi, theo tỷ giá được chốt tại thời điểm đó;
  • có thể đổi sang coin khác cho đến khi phát hiện được thanh toán;
  • theo dõi trạng thái thay đổi trực tiếp, từ đang chờ đến đang xác nhận rồi đã thanh toán.

Mỗi hóa đơn chỉ mở trong một thời gian giới hạn, được hiển thị bằng đồng hồ đếm ngược. Nếu hết thời gian mà chưa thấy khoản thanh toán nào, hóa đơn sẽ hết hạn. Nếu bạn đặt redirect_url, khách hàng có thể quay lại trang web của bạn sau khi thanh toán.

Nếu khách hàng đã thanh toán nhưng khoản thanh toán không hiện ra trước khi hóa đơn hết hạn, họ có thể báo cáo từ trang hóa đơn. Khi đó, địa chỉ sẽ được ngừng cấp phát và tiếp tục được theo dõi, và đội ngũ hỗ trợ của chúng tôi sẽ kiểm tra khoản thanh toán.

Liên kết thanh toán là một liên kết dùng nhiều lần cho một sản phẩm, dịch vụ hoặc khoản quyên góp, tại /pay/l/<link_id>. Hãy đặt tiêu đề và một số tiền cố định, hoặc để trống số tiền để khách hàng tự nhập. Mỗi khoản thanh toán qua liên kết sẽ trở thành một hóa đơn riêng.

Tạo liên kết trong cổng quản lý, mục Liên kết thanh toán, hoặc bằng API.

Bản xem trước khi chia sẻ

Khi bạn chia sẻ liên kết thanh toán hoặc trang thanh toán của mình trên WhatsApp, Telegram, Instagram, X và các ứng dụng tương tự, ứng dụng sẽ hiển thị một thẻ xem trước. Thẻ này có tên cửa hàng của bạn, tên miền đã xác minh nếu có, và các coin bạn chấp nhận. Với liên kết thanh toán, thẻ còn hiển thị sản phẩm và giá của sản phẩm đó.

Liên kết thanh toán không được liệt kê trên các công cụ tìm kiếm, nên một liên kết chỉ đến được những người bạn chia sẻ.

Tên miền đã xác minh

Nếu bạn đã xác minh tên miền trang web của mình, trang thanh toán, liên kết thanh toán, trang hóa đơn và trang hoàn tiền của bạn sẽ hiển thị tên miền bên cạnh tên cửa hàng, ví dụ shop.com · đã xác minh. Điều này cho khách hàng biết cửa hàng trên trang đó kiểm soát DNS của tên miền ấy. Xem cách xác minh tên miền của bạn.

Tỷ giá

Hóa đơn được định giá bằng một loại tiền tệ như đô la Mỹ. Khi khách hàng chọn coin, số tiền bằng coin đó được tính từ giá trực tiếp và được chốt. Stablecoin như USDT và USDC được tính là một đô la Mỹ mỗi đồng. Nếu khoản thanh toán được thấy lần đầu khi hóa đơn vẫn còn mở, tỷ giá đã chốt sẽ được áp dụng.

Khách hàng thanh toán từ sàn giao dịch

Sàn giao dịch thường trừ phí rút tiền vào số tiền khách hàng nhập, nên số tiền đến nơi ít hơn số đã gửi. Đây là nguyên nhân phổ biến nhất khiến hóa đơn bị thanh toán thiếu. Trang hóa đơn có ghi chú Thanh toán từ sàn giao dịch? nhắc khách hàng đảm bảo toàn bộ số tiền đến nơi.

Khi có thông tin phí rút tiền của Binance cho coin và mạng đó, ghi chú cũng hiển thị mức phí và tổng số tiền cần nhập trên Binance. Các sàn khác thu phí riêng, khách hàng nên kiểm tra trên màn hình rút tiền.

Sai coin hoặc sai mạng

Đôi khi khách hàng thanh toán bằng một coin khác với coin hóa đơn yêu cầu, hoặc trên một mạng khác. Crypto Merchant theo dõi mỗi địa chỉ hóa đơn cho mọi coin được hỗ trợ, trên mọi mạng được hỗ trợ dùng địa chỉ đó, nên những khoản thanh toán này đều được phát hiện.

Một địa chỉ EVM dùng được trên Ethereum, BNB Smart Chain, Polygon, Base và Arbitrum One, và chúng tôi giữ khóa của nó trên tất cả các mạng này. Vì vậy, USDC gửi trên Base đến một hóa đơn yêu cầu USDC trên Ethereum vẫn đến một địa chỉ do chúng tôi kiểm soát. Tron, Bitcoin, Litecoin, Solana, TON và XRP Ledger mỗi mạng có loại địa chỉ riêng. Trên các mạng đó, cơ chế này áp dụng cho một coin khác trên cùng mạng, ví dụ TRX gửi đến hóa đơn USDT trên Tron.

Khi nào khoản thanh toán được tự động tính

Khoản thanh toán tự động được tính cho hóa đơn khi cả hai điều kiện sau đều đúng:

  • chưa có khoản nào khác được thanh toán cho hóa đơn;
  • số coin đủ trả số tiền hóa đơn, trong phạm vi mức dung sai thanh toán thiếu của bạn.

Khi đó, hóa đơn chuyển sang coin thực sự được gửi. Trang hóa đơn cho khách hàng biết họ đã thanh toán bằng coin nào thay cho coin được yêu cầu. Bạn thấy Coin được yêu cầu trên khoản thanh toán và trong email thanh toán. Trong API, coin là coin đã được thanh toán và requested_coin là coin hóa đơn yêu cầu.

Số coin được định giá như sau:

  • stablecoin như USDT và USDC được tính mỗi đồng bằng một đô la Mỹ;
  • cùng một coin trên mạng khác, chẳng hạn ETH trên Base cho hóa đơn bằng ETH trên Ethereum, giữ nguyên tỷ giá đã hiển thị cho khách hàng;
  • mọi coin khác được định giá theo giá thị trường tại thời điểm coin đến.

Cơ chế này cũng áp dụng cho thanh toán trễ: khi hóa đơn đã hết hạn nhưng địa chỉ của nó vẫn đang được theo dõi, tức là trong ít nhất 24 giờ.

Số tiền nhỏ hơn và token lạc

Mọi trường hợp khác đều không bao giờ thay đổi hóa đơn: thanh toán một phần bằng coin khác, một coin thứ hai trên hóa đơn đã có khoản thanh toán, hoặc một token lạc. Số tiền đó được ghi có vào số dư của bạn như một khoản thanh toán không có hóa đơn, sau khi trừ phí 1%, và một yêu cầu hỗ trợ sẽ thông báo cho bạn, để bạn có thể giải quyết với khách hàng. Một token rất nhỏ gửi đến địa chỉ không thể chiếm quyền một hóa đơn.

Thanh toán trễ cho một hóa đơn đã hủy hoặc đã hoàn tiền cũng được xử lý theo cách tương tự: số tiền được ghi có vào số dư của bạn, và bạn nhận được một yêu cầu hỗ trợ.

Những gì vẫn có thể bị mất

Coin trên mạng hoặc loại coin mà Crypto Merchant không hỗ trợ, và coin gửi đến bất kỳ địa chỉ nào khác ngoài địa chỉ của hóa đơn, không thể được tính và có thể bị mất vĩnh viễn. Khách hàng vẫn nên gửi đúng coin được hiển thị, trên đúng mạng được hiển thị.

Hóa đơn thanh toán thiếu

Bạn đặt mức dung sai thanh toán thiếu trong phần cài đặt; chúng tôi khuyên ít nhất 1 US$. Nếu một khoản thanh toán đã xác nhận thiếu không quá mức dung sai, hóa đơn được tính là đã thanh toán.

Nếu khoản thanh toán thiếu nhiều hơn mức đó, hóa đơn sẽ chuyển sang thanh toán thiếu. Số đã gửi được giữ cho khách hàng, người có thể gửi phần còn lại đến cùng địa chỉ hoặc nhận hoàn lại số đã gửi về một địa chỉ họ nhập. Phí mạng cho khoản hoàn tiền được trừ vào khoản hoàn tiền.

Hóa đơn thanh toán thừa

Nếu khách hàng gửi nhiều hơn số hóa đơn yêu cầu, hóa đơn vẫn được tính là đã thanh toán. Phần thừa được xử lý tùy theo giá trị của nó:

  • Hóa đơn được tính là đã thanh toán, và phần thừa được giữ cho khách hàng. Họ có thể rút phần đó về ví của mình từ trang hóa đơn, trừ đi phí mạng khi gửi.
  • Cho đến khi họ rút, Crypto Merchant giữ phần đó cho họ. Phần thừa không được cộng vào số dư của doanh nghiệp và không bao giờ bị giữ lại làm phí.

Hoàn tiền sau khi thanh toán

Bạn có thể gửi trả tiền cho một khoản thanh toán đã hoàn tất, ví dụ khi trả hàng hoặc hủy đơn. Mở khoản thanh toán trong cổng quản lý và dùng Hoàn tiền khoản thanh toán này. Chỉ Quản trị viên mới có thể làm việc này, và trước tiên họ phải xác nhận đó là mình bằng một mã mới từ email hoặc ứng dụng xác thực.

  • Bạn có thể hoàn bất kỳ số tiền nào, tối đa bằng số bạn giữ lại từ khoản thanh toán đó: số đã được ghi có cho bạn sau phí 1%, trừ các khoản hoàn tiền trước đó và các liên kết hoàn tiền vẫn đang mở. Phí 1% không được hoàn lại.
  • Số tiền được tạm giữ khỏi số dư của bạn ngay lập tức, nên không thể bị chi trả nhầm trong thời gian đó.
  • Nếu khoản thanh toán có email của khách hàng, họ sẽ nhận được email kèm một liên kết riêng. Bạn cũng có thể sao chép liên kết và tự gửi cho họ.
  • Khách hàng mở liên kết, nhập địa chỉ của chính họ cho coin và mạng đó, đánh dấu xác nhận rồi gửi. Khoản hoàn tiền được gửi từ ví pool của bạn, và phí mạng được trừ vào khoản hoàn tiền.
  • Một liên kết mở trong 14 ngày. Nếu khách hàng không nhận kịp thời hạn, hoặc bạn hủy liên kết, số tiền sẽ tự động quay về số dư của bạn. Mỗi liên kết chỉ được nhận một lần.

Hoàn tiền một phần giữ khoản thanh toán ở trạng thái Đã thanh toán và hiển thị số tiền đã hoàn. Hoàn toàn bộ số bạn giữ lại sẽ đánh dấu khoản thanh toán là Đã hoàn tiền. Mỗi lần nhận sẽ gửi một webhook invoice.refunded, và đối tượng hóa đơn hiển thị tổng số trong refunded_amount.

Vì khách hàng tự nhập địa chỉ vào trang hoàn tiền, không ai phải trao đổi địa chỉ qua tin nhắn, nơi một lỗi đánh máy hoặc kẻ mạo danh có thể khiến coin bị gửi sai chỗ. Giao dịch chuyển crypto không thể đảo ngược, nên khách hàng phải nhập một địa chỉ mà họ kiểm soát, trên đúng mạng được hiển thị.

Hóa đơn thanh toán thiếu vẫn có tùy chọn hoàn tiền riêng cho khách hàng trên trang hóa đơn, và khách hàng vẫn có thể rút khoản thanh toán thừa từ đó, như mô tả ở trên. Hoàn tiền không thu hồi các phần đã được tạm giữ cho đối tác chia doanh thu.

Phí

1% trên mỗi hóa đơn đã thanh toán được khấu trừ khi khoản thanh toán được ghi có vào số dư của bạn. Hóa đơn hết hạn và bị hủy không mất phí.

Không có phí thêm khi một khoản thanh toán được tính sau khi đến bằng coin khác hoặc trên mạng khác. Khi bạn hoàn tiền một khoản thanh toán, phí 1% không được hoàn lại, và phí mạng của khoản hoàn tiền được trừ vào khoản hoàn tiền.

Số tiền cần trả cũng bao gồm phí gas để chuyển khoản thanh toán đó vào ví pool của bạn, không bao giờ quá 5 US$. Trên hầu hết các mạng, phí này chỉ vài cent. USDT trên Tron tốn nhiều hơn, vì Tron đốt năng lượng cho mỗi lần chuyển token. Trang thanh toán hiển thị phí này bên cạnh giá, và API trả về phí này dưới dạng network_fee_amount và network_fee_usd. Phí này trang trải lượt gom của khoản thanh toán đó, không phải doanh thu của bạn, và không bị tính phí thanh toán.