常见问题
这页回答商家在开通、接入、测试和上线时最常遇到的问题。
我应该先看哪几页
如果你刚开始接触 Taria Pay，推荐顺序是：
如果你要把支付接进网站，直接看：
我只是想尽快开始收款，不想先改网站
它们适合先跑通收款，再决定是否把 Taria Pay 深度接进你的网站。
我想把 Taria Pay 加到自己的网站里，应该从哪里开始
从 快速接入 开始。
推荐做法是让你自己的服务端创建 payment intent，然后把 checkoutUrl 返回前端做跳转。
API key 和 webhook 在哪里配置
在商家后台的 Developers 页面：
- API Keys：创建和吊销 test / live key
- Webhooks：创建 endpoint 并获取 signing secret
- Delivery Logs：查看 webhook 投递结果和失败原因
用户付了钱，但我网站上的订单状态还没更新
优先检查：
- webhook endpoint 是否已经配置。
- webhook signing secret 是否正确。
- 你的服务端是否完成验签并返回
2xx。 - 你的订单更新逻辑是否按
paymentId或orderId幂等处理。 - Delivery Logs 是否显示投递失败。
继续阅读：排查支付问题
买家回到 success 页，是否代表可以发货
不一定。successUrl 只代表买家浏览器回到了你的网站。发货、开通权益和记账应以 webhook 的支付确认事件或查询接口结果为准。
我需要在创建支付订单时传 chainId 吗
通常不需要。你的服务端创建 payment intent 时提供订单号、金额、币种和跳转地址即可。结账页会展示当前可用的支付网络。
我能控制结账页展示哪种付款方式吗
可以。创建支付订单时用可选的 paymentMethods 字段：可以关掉钱包模块或直接转账（两者不能同时关），也可以让转账区默认展开。不传时保持默认（两种都展示、转账收起）。详见创建支付订单。
买家不会用钱包，能完成付款吗
可以。在支持的网络上，结账页除了钱包支付，还提供直接转账：页面展示该订单专属的收款地址和二维码，买家从交易所提币或任意钱包按展示的网络、币种、金额转账即可，到账后自动确认。你不需要为此做任何接入改动，webhook 事件与钱包支付一致。详见支持的付款方式。
我以前分享出去的收款链接还能用吗
能。结账链接现在统一为 checkout.tariapay.com/ 加一个带类型前缀的 ID（例如 pi_…、pl_…、su_…），但所有已经发出去的旧形态链接会一直有效，不需要重新分享。接口返回的 checkoutUrl 永远是当前的权威形态，直接使用即可。
需要人工支持时怎么办
发送邮件到 support@tariapay.com。
建议附上：
- 商户邮箱
- 商户订单号
paymentId- 交易哈希
- 问题页面截图
- 发生问题的大致时间