方法名称
hotel.order.pay
使用说明
在创建订单是选择仅创建订单或者第一次支付失败后,可以使用本接口在规定的时间内继续进行支付。
支付失败后,如果放弃这个订单请取消该订单。
更为细致的使用说明请前往以下链接查看:http://open.elong.com/faq/detail?id=121&plt=2
须使用https访问本接口。
支付方式
信用卡支付发送短信验证码环节,短信验证码限制是90秒/次,可通过hotel.order.pay接口重新发送验证码。
信用卡支付退款时间:离店后担保金退回各个银行处理退款进度是不同的,预计3-15工作日原路退回。
建议使用信用卡支付合作方在页面进行提示,避免造成不必要客诉。
输入参数
节点 | 名称 | 类型 | 可为空 | 说明 |
---|---|---|---|---|
OrderId | 订单号 | Long | N | |
IsGuaranteeOrCharged | 是否已担保或已付款 | Boolean | N | 开通了公司担保业务的合作伙伴才能使用该属性,有关支付逻辑的详细说明请参考这里 |
CreditCard | 信用卡 | CreditCard | Y | 担保订单和预付订单才须传信用卡 参考CreditCard节点 |
DoveCorpCard | 第三方支付 | DoveCorpCard | Y | 担保订单和预付订单才须传第三方支付信息。 如果IsGuaranteeOrCharged为false,则一定不能传第三方支付信息。 参考DoveCorpCard节点 |
Amount | 支付金额 | Decimal | N | 人民币价格 |
响应结果
节点 | 名称 | 类型 | 可为空 | 说明 |
---|---|---|---|---|
IsSuccess | 支付请求是否接收成功 | Boolean | N | 该字段表示艺龙分销系统是否成功接收到了支付请求,不代表支付成功,是否支付成功请查看:http://open.elong.com/faq/detail?plt=2&id=121 |
notes | 备注(失败原因) | string | Y |
输入示例
https://api-test.elong.com/rest?format=json&method=hotel.order.pay &user={userid}×tamp=1488508207&signature=1b34c24f5c31381a67c666f4dc211077 &data={"Version":"1.28","Local":"zh_CN","Request": {"OrderId":"1234567","IsGuaranteeOrCharged":"true","Amount":"200.0"}}
输出示例
{ "Code":"0", "Result":{ "IsSuccess": true } "Guid":"196d84d9-19b1-4aa2-8891-1c699e806a3c" }
注意事项
当接口返回错误的时候,需要重试,控制下重试的时间间隔在30s以上。
在不确定是否支付成功前,不要重复支付。
常见错误码
错误码 | 解释 | 解决方法 |
---|---|---|
H001013 | 是否已担保或已付款必须填写 | 开通了公司担保业务,如果订单需要支付,则IsGuaranteeOrCharged必须为true,且不能传入信用卡信息。 |
H001037 | 信用卡失效或已担保或已支付业务已经失效 | 可能的原因有两个,一是没有开通虚拟卡业务的,那么就是传入的信用卡失效,让客户传入可用的信用卡;如果开通了虚拟卡业务,则是虚拟卡过期,联系商务解决。 |
H001039 | 预付或强制担保订单必须设置为已经担保或已经支付 | 开通了公司担保业务,如果订单需要支付,则IsGuaranteeOrCharged必须为true,且不能传入信用卡信息。 |
H001040 | 无支付或担保权限,不能设置为已经担保或已经支付 | 即没有开通虚拟卡业务,如要开通,需要联系商务。 |
H001041 | 使用已担保或已支付业务,不需要提供信用卡信息 | 开通了公司担保业务,如果订单需要支付,一定不要传入信用卡信息。 |
H001152 | 预付或强制担保订单使用虚拟卡业务,不需要提供信用卡信息与第三方支付信息 | 开通公司担保业务且未开通公司第三方支付,如果订单需要支付,一定不要传入信用卡信息与第三方支付信息。 |
H001153 | 预付或强制担保订单使用第三方支付业务,不需要提供信用卡信息 | 开通公司第三方支付,如果订单需要支付,一定不要传入信用卡信息。 |
H001154 | 预付或强制担保订单使用第三方支付业务,需要提供第三方支付信息 | 开通公司第三方支付,如果订单需要支付,需要提供第三方支付信息。 |
H001155 | 无支付或担保权限,不需要提供第三方支付信息 | 未开通公司第三方支付,一定不要提供第三方支付信息。 |
H001156 | 无法确认开通支付业务的权限类型(虚拟卡业务或第三方支付业务) | 担保业务与第三方支付业务不能同时开通,需联系商务解决。 |
H001044-3 | 计算订单价格失败 | 重试,反复出现请联系技术人员解决。 |
H001044-4 | 计算订单担保金额失败 | 重试,反复出现请联系技术人员解决。 |
H001044-6 | 货币种类错误 | 注意港澳台币 |
H001044-95 | VouchType与担保规则冲突 | 产品需要担保则需要必须传入担保信息,如果不需要担保,则一定不要传入担保信息。 |