基础 qianmi.elife.train.order.refund(退订火车票订单)

交易完成,取消订单,支持选择子单退订:
1.退订订单状态前提:已完成(state-1),已支付( billstate 1);
2.人工充值的火车票,退订时,不自动退保险,需供货商人工操作退款;
3.非人工充值的火车票,退订时,自动退保险。
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://api.bm001.com/api https://api.bm001.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 必须 接入码,获取方式:登录直销商系统(sale.bm001.com),进入“数据中心” > “开发工具”。
vString 必须 API协议版本,当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
orderNosString 必须 P141222161001880,P141222161001880 订单子单编号,多个时以‘,’分隔
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
TrainOrderRefundRequest req = new TrainOrderRefundRequest();
req.setOrderNos("P150813161105467,P150813161105467");
req.setReturnType("1");
TrainOrderRefundResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new TrainOrderRefundRequest;
$req->setOrderNos("P123322255511");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
TrainOrderRefundRequest req = new TrainOrderRefundRequest();
req.OrderNos = "P123322255511";
TrainOrderRefundResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
result String 1 操作结果 1 成功
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": [{
      "code": "isv.invalid-paramete:XXXX",
      "message": "参数XXXX无效,格式不对、非法值、越界等"
    }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-elife-train-order-refund-service-error:00059001传入参数错误检查传入参数是否有为空
isv.qianmi-elife-train-order-refund-service-error:00059002传入参数为空检查传入参数
isv.qianmi-elife-train-order-refund-service-error:00051006交易订单支付用户与订单买家用户不符检查订单编号和买家编号
isv.qianmi-elife-train-order-refund-service-error:00050704订单不存在检查订单号
isv.qianmi-elife-train-order-refund-service-error:00050707保险订单不存在检查保险单号
isv.qianmi-elife-train-order-refund-service-error:00059000系统异常检查环境
isv.qianmi-elife-train-order-refund-service-error:00051023确认交易子单状态为出票成功,请勿重复操作确认交易子单状态为出票成功,请勿重复操作
isv.qianmi-elife-train-order-refund-service-error:00051019火车票退订网络异常,请调用查询订单接口确认最终状态调用查询订单接口确认最终状态
 FAQ