ApplyRefund订单退款接口
退款接口应用必读【三方产品退款注意事项】
1、获取产品清单接口、获取订单状态接口中声明为“HasETicket”的产品为三方产品;
2、三方产品退款只是发起申请,由我方系统自动完成涉及到第三方对接的状态同步,需要异步处理,因此本接口调用成功只表示退款请求发起成功,不代表真正退款成功。具体处理退款成功,可能会有时间上的延迟。
3、三方产品退款对接方还需要在发起退款申请后,通过以下两种方式中的一种进行后续处理,方可在已方平台退款给买家。:
①(★推荐)提供退款回调接口,我方处理完退款后会调用该回调接口;
②一定时间或次数范围内,持续查询订单状态,直至确认我方订单状态由【已付款】变更为【退款成功】。
4、如果退款处理完成,退款金额将返还到对接方在我方系统中的余额。
5、过期的直通车订单(发车前2小时),将不能退车券,只能退门票。
【非三方产品】
1、获取产品清单接口、获取订单状态接口中声明为“HasETicket=false”的产品为非三方产品;
1、非三方产品调用退款接口成功即退款成功。
1、首先应在用户发起退款时确定是否满足以下其中一项,满足时应通过 订单查询 接口获取退款明细供游客确认(效果图):
明细总预定量≠总可退款数、产生手续费、使用了优惠券
即:totalCopies != totalRefundCopies || factorageAmount > 0 || CouponAmount>0
2、如不满足上述条件,可不必向游客展示退款确认直接发起退款。
HTTPS请求方式:POST url:https://youdali.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 |