最佳实践
本文为您整理了一系列提升产品体验和支付效率的实用方案，助力您的业务增长：
智能风控服务
EasySafePay 内置智能风控系统，在创建支付会话时需准确传入风控字段（字段说明中有用于风险控制的说明）。这些数据的准确性和完整性将直接影响系统的风险识别效果。
以下字段对风控管理至关重要，请确保准确传输。具体字段规范请参阅 支付会话创建（快捷支付）。
类型 | 字段 | 字段描述 |
设备和环境字段 | env.clientIp | 客户端设备的 IP 地址。 |
订单字段 | order.goods：
| 包含商品 ID、名称、类目、价格、数量、链接、配送方式在内的商品详情。 |
order.shipping：
| 包含收件人信息与物流承运商名称在内的物流信息，若为虚拟商品，需提供接收邮箱 shipToEmail。 | |
order.buyer:
| 包含买家 ID、电话、邮箱、注册时间在内的买家信息，其中，ID、电话或邮箱可三选一传入。 |
安全扩展包
集成 SDK 资源包时，请按规范添加安全扩展包，iOS 端操作请参阅安全扩展包，Android 端操作请参阅安装安全扩展包。
该组件将采集终端设备信息用于风险识别，以增强支付安全性与服务可靠性。
结果页跳转后的订单查询
调用 支付结果查询 接口，建议根据不同支付状态在结果页显示内容。
- 支付成功：显示与发货相关的内容。
- 支付失败：提供重新支付操作指引。
- 支付处理中：
- 显示加载状态并暂停 3-5 秒，然后自动发起二次查询。
- 持续返回处理中状态时，提示“订单处理中，请稍后于订单管理门户查看结果”。
注意：
- 避免使用“网络延迟”等非确定性描述。
- 所有状态提示需与接口返回严格一致。
商户侧主动取消交易
若商户订单超时关闭时间早于 Antom 支付单超时时间，可能出现在订单关闭后仍收到支付成功通知的情况。此时需调用 取消支付 接口为买家发起退款。
支付失败重试
当订单支付失败且允许同一订单重试时，建议按以下流程集操作：
- 在支付请求中设置 referenceOrderId 为订单 ID，paymentRequestId 为支付订单 ID；
- 重试支付前检查订单状态：若已成功则提示“已完成支付”，若处理中或失败则重新调用 支付会话创建（快捷支付）接口获取新 paymentSessionData；
- 确保单订单仅关联一次成功支付，如检测到重复成功支付，调用 取消支付 接口发起退款。