最佳实践

本文为您介绍以下多个最佳实践方案，帮助您提升产品体验及支付效率：

• 支付结果展示
• 商户侧订单关闭
• 支付失败重试
• 接口超时时间设置

支付结果展示

调用 pay（令牌支付）接口后，请您根据以下建议处理不同的结果：

• 支付成功：支付成功后，支付结果页面将展示与发货相关的内容。
• 支付失败：提示支付失败，并提供重试支付的引导，以促进订单完成。
• 支付处理中：展示加载效果，并在 3-5 秒内暂停，随后再次查询服务器以获取支付结果。如果结果仍然未知（既不是成功也不是失败），建议展示“订单处理中”或“通过订单管理门户查看最终结果”，避免将延迟归因于“网络处理中”。Antom 最晚会于 1 分钟内通知最终支付结果。

商户侧订单关闭

若商户侧的订单设置了关闭订单时间（即指定时间内未完成支付）且此时 Antom 支付单据并未推进到成功或者失败的状态，则在商户关闭订单时，也需要调用 cancel 接口取消该支付订单来保证双方单据状态一致。

支付失败重试

订单的支付尝试失败，且买家可以为同一订单重试支付时，建议您遵循以下步骤以实现买家的无缝体验：

1. 在 pay（令牌支付）请求中，将 referenceOrderId 设置为订单 ID，将 paymentRequestId 设置为支付订单 ID。
2. 如果需要对同一订单重试支付，请先检查订单状态：

• 如果支付成功，向买家展示“已完成支付”。
• 如果支付未成功，建议调用 cancel 接口取消该次支付后，使用新的 paymentRequestID 再次调用 pay（令牌支付）接口进行一笔新的支付。

3. 确保每个商户订单只与一个成功的支付相关联。如果检测到单个订单有多个成功的支付，调用 取消支付 接口来为买家发起退款。

接口超时时间设置

在某些情况下，支付方式的订单接口处理延迟可能无法及时收到响应。若您有设置接口超时时间，建议将接口超时时间设置为 10 秒。若支付调用超时，建议等待异步通知或者调用 inquiryPayment 接口获取支付结果。