订单退款

ApplyRefund订单退款接口

退款接口应用必读

【三方产品退款注意事项】

1、获取产品清单接口获取订单状态接口中声明为“HasETicket”的产品为三方产品;

2、三方产品退款只是发起申请,由我方系统自动完成涉及到第三方对接的状态同步,需要异步处理,因此本接口调用成功只表示退款请求发起成功,不代表真正退款成功。具体处理退款成功,可能会有时间上的延迟。

3、三方产品退款对接方还需要在发起退款申请后,通过以下两种方式中的一种进行后续处理,方可在已方平台退款给买家。:

     ①(★推荐)提供退款回调接口,我方处理完退款后会调用该回调接口;
     ②一定时间或次数范围内,持续查询订单状态,直至确认我方订单状态由【已付款】变更为【退款成功】。

4、如果退款处理完成,退款金额将返还到对接方在我方系统中的余额。

5、过期的直通车订单(发车前2小时),将不能退车券,只能退门票。

【非三方产品】

1、获取产品清单接口获取订单状态接口中声明为“HasETicket=false”的产品为非三方产品;

1、非三方产品调用退款接口成功即退款成功。

退款接口建议流程

1、首先应在用户发起退款时确定是否满足以下其中一项,满足时应通过 订单查询 接口获取退款明细供游客确认(效果图):

     明细总预定量≠总可退款数、产生手续费、使用了优惠券
     即:totalCopies != totalRefundCopies || factorageAmount > 0 || CouponAmount>0

2、如不满足上述条件,可不必向游客展示退款确认直接发起退款。

接口:发起退款申请

HTTPS请求方式:POST

url:https://www.qudali.com/OpenApi/ApplyRefund

使用调试工具调试该接口
参数 类型 长度 可空 描述
apiKey string 32 由官方平台提供的apiKey
number string 20 订单Id
sign string 32

由apiSecret,与参数number生成的待签名字符串,通过MD5签名运算后的值。

签名规则
返回说明

Json格式的Result对象

{
    "ErrorCode": 0,
    "Success": true,
    "Message": null,
    "HasException": false,
    "Value": null,
    "Tag": null
}
返回值 描述
Success 本次调用是否成功
ErrorCode 错误代码
Message 失败时为异常信息,成功时为null
Value
Tag 如无特别说明,在返回数据带分页的情况下,Tag一般指查询记录的总条数,其它情况为null