什么时候应该用支付链接而不是集成?
两者是同一条通道,不是两个产品:支付链接通过与 API 订单相同的订单创建路径创建,你复制
的 URL 就是
orderAction.webUrl 返回给 API 集成的那个托管支付页面。不同之处在于谁创建
订单——Portal,还是你的服务器。
创建链接时我要填什么?
Product 必须是你的 Payin 合约上已启用的——查看 Portal 中的 Service → Payin。
不在你合约中的产品会校验失败,和在
/api/v1/order/create 上的表现一样。
提交后你会得到一个确认对话框,包含描述、金额和币种、国家,以及带复制按钮的链接本身。
在那里复制并分享它——那就是链接交到你手上的时刻。
链接过期是怎么工作的?
- 将 Order Expired At 留空,则应用为你账户配置的默认订单过期窗口。Portal 在 Order Expired At 列的提示中显示该默认值。
- 选择一个日期和时间以覆盖它。选择器会屏蔽过去的日期;在请求处理时已经过去的过期 时间会被忽略,改为应用默认值。
- 给付款人留出可用的时间。只有几分钟的窗口会被接受,但几乎没有时间完成支付——尤其是 涉及银行 App 或柜台步骤的支付方式。
ORDER_CLOSE),链接不再能完成支付。过期是该页面提供的
唯一失效机制。
我可以取消或复用链接吗?
没有撤销按钮。 列表唯一的行操作是 Copy URL。如果你需要提前关闭链接并且拥有 API 集成,可以用列表中显示的acquiringOrderId 通过 POST /api/v1/order/cancel 取消
底层订单——取消在订单仍开放时可行,成功后则不行。否则,请在创建链接时设置较短的过期时间。
不可复用。 每个链接都与恰好一笔订单一起创建:
把链接当作一张单独的发票,而不是可复用的”付款给我”页面。因为它背后的对象是一笔普通的
收单订单,下游一切行为都正常:它出现在 Transactions → Payments 中,可以在那里按
Acquiring Order ID 搜索,并像任何其他订单一样退款、对账和结算。
我在哪里查看我创建的链接,以及它们是否已支付?
Payment Link 列表按最新优先显示:
状态值就是你在 Transactions → Payments 中已经见到的订单状态:
AUTHORIZATION_REQUIRED(链接已下发,付款人尚未完成)、PAY_IN_PROGRESS、
AUTHED_WAITING_CAPTURE、CAPTURE_IN_PROGRESS、PAY_SUCCESS,以及 ORDER_CLOSE(已关闭,
包括已过期和被放弃的链接)。
这个页面是创建日志,不是分析视图:它没有筛选也没有导出。要筛选、查看交易详情、退款和
收据,请带着 Acquiring Order ID 到 Transactions → Payments 操作。
链接创建失败了。现在怎么办?
创建运行的是与 API 订单创建相同的校验,所以常见原因同样适用:你的合约上未启用的产品、 国家或币种,或你的账户无法服务的支付方式组合。错误消息会指出有问题的参数——先对照 你的 Service → Payin 页面检查。需要本页未覆盖的行为——可复用链接、订单上带你自己的订单 ID,或程序化创建?那正是 API 集成 路径的用途。 当某个特定链接行为异常时,请附上 Acquiring Order ID 联系客服。