跳到主要内容
Crypto Merchant

基础

收银台

客户在 Crypto Merchant 托管的页面上付款。您无需拥有网站:分享您的收银台页面或支付链接即可。如果您有网站,可以通过 API 创建账单,并将客户引导至账单页面。

您的收银台页面

每个店铺都有自己的收银台页面,地址为 /pay/<store>,其中 <store> 是您店铺的简称。客户可以在该页面输入金额,或选择您的某个支付链接。您可以在任何与客户沟通的地方分享它:您的网站、社交主页、聊天或邮件。

您可以在后台的您的收银台页面中找到该链接。

账单页面

每张账单都有自己的页面,地址为 /pay/i/<invoice_id>。API 会以 checkout_url 返回此链接。在该页面上,客户可以:

  • 从您接受的币种和网络中选择一个;
  • 看到为此账单生成的收款地址及二维码,以及需要发送的准确金额,汇率在那一刻锁定;
  • 在检测到付款之前切换到其他币种;
  • 实时查看状态变化,从等待付款到确认中,再到已付款。

每张账单的有效时间有限,以倒计时显示。如果在检测到任何付款之前时间用完,账单就会过期。如果您设置了 redirect_url,客户付款后可以返回您的网站。

如果客户已付款,但在账单过期前付款未显示,客户可以在账单页面上报告。该地址随后会停止轮换使用并持续受到监控,我们的客服团队会核查这笔付款。

支付链接是用于单个商品、服务或捐款的可重复使用链接,地址为 /pay/l/<link_id>。为其设置标题,并设置固定金额,或将金额留空由客户输入。通过链接完成的每笔付款都会生成一张独立的账单。

在后台的支付链接中创建链接,或使用 API 创建。

分享预览

当您在 WhatsApp、Telegram、Instagram、X 等应用中分享支付链接或收银台页面时,应用会显示一张预览卡片。卡片上有您的店铺名称、您的已验证域名(如有)以及您接受的币种。对于支付链接,还会显示商品及其价格。

支付链接不会被搜索引擎收录,因此只有您分享给的人才能看到链接。

已验证域名

如果您已验证网站域名,您的收银台页面、支付链接、账单页面和退款页面会在店铺名称旁显示该域名,例如 shop.com · 已验证。这向客户表明,页面上的店铺控制着该域名的 DNS。请参阅如何验证您的域名。

汇率

账单以美元等货币计价。客户选择币种后,该币种的金额会根据实时价格计算并锁定。USDT 和 USDC 等稳定币各按 1 美元计算。如果付款在账单仍有效时被首次检测到,则适用锁定的汇率。

从交易所付款的客户

交易所通常会从客户输入的金额中扣除提币手续费,因此到账金额少于发送金额。这是账单少付最常见的原因。账单页面上有一条从交易所付款?提示,请客户确保全额到账。

如果能获取 Binance 对该币种和网络的提币手续费,提示中还会显示该手续费以及需要在 Binance 输入的总额。其他交易所收取各自的手续费,客户应在提币页面上查看。

错误的币种或错误的网络

客户有时会使用与账单要求不同的币种付款,或在不同的网络上付款。Crypto Merchant 会在使用该地址的每个受支持网络上,针对每种受支持的币种监控每个账单地址,因此这些付款都能被检测到。

同一个 EVM 地址可在 Ethereum、BNB Smart Chain、Polygon、Base和Arbitrum One 上使用,我们在所有这些网络上都持有其密钥。因此,如果账单要求在 Ethereum 上支付 USDC,而客户在 Base 上发送了 USDC,币仍会到达我们控制的地址。Tron、Bitcoin、Litecoin、Solana、TON和XRP Ledger 各自有自己类型的地址。在这些网络上,此规则适用于同一网络上的其他币种,例如发送到 Tron 上 USDT 账单的 TRX。

何时自动计入

当以下两个条件都满足时,该付款会自动计入账单:

  • 账单上尚未有其他付款;
  • 在您的少付容差范围内,这些币足以支付账单金额。

随后,账单会切换为实际发送的币种。账单页面会告诉客户他们使用了哪种币种付款,而不是原定的币种。您会在付款详情和付款邮件中看到原定币种。在 API 中,coin 是实际支付的币种,requested_coin 是账单原定的币种。

这些币的计价方式如下:

  • USDT 和 USDC 等稳定币每枚按 1 美元计;
  • 其他网络上的同一币种,例如以 Base 上的 ETH 支付 Ethereum 上的 ETH 账单,沿用向客户显示的汇率;
  • 其他任何币种按到账时的市场价格计价。

这同样适用于逾期付款:账单已过期,但其地址仍在监控中(至少 24 小时)。

较小金额和误转代币

其他情况都不会改变账单:以其他币种的部分付款、在已有付款的账单上的第二种币,或误转的代币。这些款项会像无账单付款一样计入您的余额,扣除 1% 手续费,并通过客服工单通知您,以便您与客户结清。发送到该地址的极小额代币无法占用账单。

向已取消或已退款账单的逾期付款也以同样方式处理:计入您的余额,并且您会收到一个工单。

仍可能丢失的情况

Crypto Merchant 不支持的网络或币种上的币,以及发送到账单地址以外任何地址的币,无法计入,可能会永久丢失。客户仍应在显示的网络上发送显示的币种。

少付的账单

您可以在设置中设定少付容差;我们建议至少 US$1。如果已确认的付款短缺金额不超过容差,账单视为已付款。

如果付款短缺超出该容差,账单将变为少付状态。已发送的款项会为客户保留,客户可以将剩余部分发送到同一地址,或将已发送的金额退款到其输入的地址。退款的网络手续费从退款中扣除。

多付的账单

如果客户发送的金额超过账单要求,账单仍视为已付款。多付部分的处理方式取决于其价值:

  • 账单视为已付款,多付部分会为客户保留。客户可以在账单页面将其提取到自己的钱包,并扣除发送所需的网络手续费。
  • 在客户提取之前,Crypto Merchant 会为其保留该部分。它不会计入商家余额,也绝不会被当作手续费收取。

付款后的退款

您可以为已付款的付款退款,例如在退货或取消订单时。在后台打开该付款,然后使用为这笔付款退款。只有管理员可以执行此操作,并且需先通过邮箱或身份验证器应用中的新验证码确认是本人。

  • 您可以退款的金额最多为您从该付款中实得的金额:即扣除 1% 手续费后计入您的金额,减去之前的退款和仍未关闭的退款链接。1% 手续费不予退还。
  • 该金额会立即从您的余额中预留,因此在此期间不会被误提现。
  • 如果付款中有客户的邮箱,客户会收到一封带有私密链接的邮件。您也可以复制链接自行发送。
  • 客户打开链接,输入自己在该币种和网络上的地址,勾选确认后提交。退款从您的资金池钱包发出,网络手续费从退款中扣除。
  • 链接有效期为 14 天。如果客户未按时领取,或您取消了退款,该金额会自动退回您的余额。每个链接只能领取一次。

部分退款后,付款仍为已付款,并显示已退款金额。将实得金额全部退款后,付款会标记为已退款。每次领取都会发送一个 invoice.refunded Webhook,账单对象会在 refunded_amount 中显示总额。

由于客户是在退款页面上自己输入地址,任何人都无需在聊天中交换地址,而在聊天中,一个输入错误或一个冒充者都可能把币发到错误的地方。加密货币转账无法撤销,因此客户必须在显示的网络上输入自己控制的地址。

少付账单仍在账单页面上为客户保留其自己的退款选项,客户也仍可在那里提取多付部分,如上文所述。已为收入分成合作伙伴预留的分成不会因退款而收回。

费用

每笔已付款账单的 1% 在付款计入您的余额时扣除。已过期和已取消的账单不收费。

以其他币种或在其他网络上到账后被计入的付款,不额外收费。当您为付款退款时,1% 手续费不予退还,退款的网络手续费从退款中扣除。

应付金额还包含将该笔付款转移到您的资金池钱包的 Gas 费,最高不超过 US$5。在大多数网络上,该费用为几美分。Tron 上的 USDT 费用更高,因为 Tron 的每次代币转账都会燃烧能量。收银台页面会在价格旁边显示该费用,API 以 network_fee_amount 和 network_fee_usd 返回该费用。该费用用于该笔付款的归集,不是您的收入,也不从中收取收款手续费。