## **退款** - **请求地址**： cgi-bin/lepos\_pay\_gateway.cgi - 测试商户信息及请求密钥和回调密钥请联系我们获取。 - 生产环境走完协议流程并且联调完提交测试报告后，我司运营同事将会提供参数给贵司 - 退款一般会返回退款中的状态，如需获取真实退款状态，请调用退款查询接口 **参数:** - 请求参数 | 参数名 | 变量名 | 必填 | 限制 | 类型 | 说明 | | ---------- | ------------------ | ---- | ---- | ------ | ------------------------------------------------------------ | | 接口名 | service | M | 无 | string | unified_refund 注：此为固定值 | | 商户号 | merchant_id | M | 10 | string | 由乐刷分配 | | 商户订单号 | third_order_id | O | 64 | string | | | 乐刷订单号 | leshua_order_id | O | 32 | string | 商户订单号跟乐刷订单号必填1个，优先使用leshua_order_id | | 商户退款id | merchant_refund_id | M | 64 | string | 可以包含字母，确保同一商户下唯一 | | 退款金额 | refund_amount | M | 10 | string | 退款金额，可做部分退款 | | 随机字符串 | nonce_str | M | 32 | string | 随机字符串，长度要求32位以内 | | 通知地址 | notify_url | O | 128 | string | 接收乐刷退款结果通知的URL，需做Url Encode处理，需要绝对路径，确保乐刷能正确访问 | | 签名 | sign | M | 32 | string | MD5签名结果 | - 返回参数 | 参数名 | 变量名 | 必填 | 限制 | 类型 | 说明 | | ---------------- | ------------------------ | ---- | ---- | ------ | ------------------------------------------------------------ | | 返回状态码 | resp_code | M | 无 | string | 0 - 成功，非0 - 失败。注：此字段是通信标识,业务状态要看result_code | | 返回错误信息 | resp_msg | C | 无 | string | 错误描述：resp_code非0时返回 | | 业务结果 | result_code | M | 1 | string | 0 - 成功，非0 - 失败 | | 错误码 | error_code | O | 无 | string | 参考错误码 | | 错误码描述 | error_msg | O | 无 | string | 错误信息描述 | | 商户号 | merchant_id | M | 10 | string | 由乐刷分配 | |通道商户号|sub_merchant_id|M|无|string|微信、支付宝、QRC商户号| | 商户订单号 | third_order_id | M | 64 | string | 商户内部订单号 | | 随机字符串 | nonce_str | M | 32 | string | 随机字符串 | | 签名 | sign | M | 32 | string | MD5签名结果 | | 订单状态 | status | M | 无 | string | 详见下方订单状态 | | 乐刷订单号 | leshua_order_id | M | 32 | string | 乐刷订单号 | | 退款金额 | refund_amount | M | 无 | string | 退款金额 | | 商户退款id | merchant_refund_id | M | 64 | string | | | 乐刷退款id | leshua_refund_id | M | 32 | string | | | 订单总金额 | total_amount | M | 无 | string | 订单总金额 | | 订单余额 | order_balance | M | 无 | string | 订单余额：本次退款后订单剩余金额 | | 实际退款金额 | settlement_refund_amount | O | 无 | string | 实际退款金额 | | 折扣优惠退款金额 | discount_refund_amount | O | 无 | string | 折扣优惠退款金额 | | 退款优惠详情 | refund_detail | O | 无 | string | 退款优惠详情 | **订单状态** | 值 | 说明 | | :--- | :------- | | 0 | 支付中 | | 2 | 支付成功 | | 6 | 订单关闭 | | 8 | 支付失败 | | 10 | 退款中 | | 11 | 退款成功 | | 12 | 退款失败 |