api可视化工具>>

酒店

酒店-订单支付更新时间:2023/02/23 11:31

方法名称

hotel.order.pay

使用说明

  1. 在创建订单是选择仅创建订单或者第一次支付失败后,可以使用本接口在规定的时间内继续进行支付。

  2. 支付失败后,如果放弃这个订单请取消该订单。

  3. 更为细致的使用说明请前往以下链接查看:http://open.elong.com/faq/detail?id=121&plt=2

  4. 须使用https访问本接口。


支付方式


信用卡支付发送短信验证码环节,短信验证码限制是90秒/次,可通过hotel.order.pay接口重新发送验证码。


信用卡支付退款时间:离店后担保金退回各个银行处理退款进度是不同的,预计3-15工作日原路退回。


建议使用信用卡支付合作方在页面进行提示,避免造成不必要客诉。


输入参数

节点名称类型可为空说明
OrderId订单号LongN
IsGuaranteeOrCharged是否已担保或已付款BooleanN开通了公司担保业务的合作伙伴才能使用该属性,有关支付逻辑的详细说明请参考这里
CreditCard信用卡CreditCardY担保订单和预付订单才须传信用卡
参考CreditCard节点
DoveCorpCard第三方支付
DoveCorpCardY担保订单和预付订单才须传第三方支付信息。
如果IsGuaranteeOrCharged为false,则一定不能传第三方支付信息。
参考DoveCorpCard节点
Amount支付金额DecimalN人民币价格

响应结果

节点名称类型可为空说明
IsSuccess支付请求是否接收成功BooleanN该字段表示艺龙分销系统是否成功接收到了支付请求,不代表支付成功,是否支付成功请查看:http://open.elong.com/faq/detail?plt=2&id=121
notes备注(失败原因)stringY

输入示例

https://api-test.elong.com/rest?format=json&method=hotel.order.pay
&user={userid}&timestamp=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-95VouchType与担保规则冲突产品需要担保则需要必须传入担保信息,如果不需要担保,则一定不要传入担保信息。