易支付

易支付订单退款流程教程

说明如何通过易支付退款接口发起退款、保存退款单号、查询退款状态并核对退款金额。

首页 > 帮助中心 > 易支付订单退款流程教程

退款要从商户服务端发起,并以接口返回和退款查询结果更新本地订单。是否可退还受订单状态、商户权限及支付通道能力影响;具体参数请同时查看订单退款接口和订单退款查询接口。

退款处理流程

确认原订单 → 核对可退金额和通道能力 → 生成退款记录 → 服务端签名并提交 → 保存响应 → 查询退款状态 → 更新本地退款记录

一、确认原订单和退款范围

  1. 用商户订单号或平台订单号定位原订单,确认平台状态为支付成功。
  2. 检查订单是否已处理过退款,并结合商户自己的售后规则计算本次退款金额。
  3. 确认当前订单和支付通道支持退款;不确定时,先查看商户后台或联系平台核实,不要把尚未确认的退款承诺给付款人。

二、为每次退款建立可追踪记录

调用退款接口时,按文档提供原订单标识和退款金额。建议为每次业务退款生成唯一的商户退款单号 out_refund_no,并在自己的数据库中记录它与原订单的对应关系,便于重试前检查和后续查询。该字段在当前接口文档中为可选项;字段要求以接口文档为准。

字段用途处理建议
trade_no / out_trade_no定位原支付订单按接口文档选择平台订单号或商户订单号。
money本次申请的退款金额使用规范的金额格式,并核对本地订单和已处理退款记录。
out_refund_no商户侧退款单号建议每笔退款使用唯一值并持久保存。
refund_no平台侧退款单号接口返回后保存,用于退款查询和客服核对。

三、从服务端发起并检查响应

  1. 在服务端按当前接口版本生成签名,再调用退款接口;不要从浏览器直接提交带密钥的请求。
  2. 保存接口返回的 code、msg、平台退款单号、商户退款单号和金额。
  3. 当前接口文档规定 code=0 表示请求成功,其他值表示失败。若请求超时或响应不完整,不要盲目重复提交;先用退款单号查询已有记录。

四、查询结果后再更新业务状态

通过退款查询接口使用平台退款单号或商户退款单号核实结果。当前查询文档中的退款状态为 0(失败)和 1(成功)。只有确认查询结果为成功,并核对原订单、退款单号和金额一致后,才把本地退款记录更新为成功。

退款接口返回失败时,保留错误信息并检查订单状态、退款金额、通道能力和签名。请求超时的情况先查询,再决定后续动作,避免重复退款或重复记账。

退款记录核对清单