API方式接入

如果您擁有自己的WEB或APP應(yīng)用系統(tǒng),希望增加火車票出票業(yè)務(wù)。本站的火車票代購電子客票業(yè)務(wù)可以通過API接入,自主從購票用戶收取票款和服務(wù)費。

接入?yún)f(xié)議:采用HTTPS協(xié)議,參數(shù)采用POST傳遞,返回采用JSON格式。

余票查詢
輸入?yún)?shù):發(fā)站、到站、日期。
說明:余票列表,展示給用戶選擇。

提交訂單
輸入?yún)?shù):選擇的車次、席別、價格、余票,乘車人姓名、身份證、手機號,注冊用戶的手機號。
說明:存儲訂單,產(chǎn)生訂單ID、預(yù)收款金額,按照預(yù)估金額凍結(jié)資金,余額不足失敗。

支付結(jié)果
輸入?yún)?shù):訂單ID、預(yù)收款金額。
說明:只有收款成功后調(diào)用。預(yù)收款金額僅是未出票之前的預(yù)估值,結(jié)算扣款以實際出票價格產(chǎn)生的金額為準(zhǔn)。

查詢訂單列表
輸入?yún)?shù):注冊用戶的手機號。
說明:用戶半年內(nèi)訂單列表。

查詢訂單詳細
輸入?yún)?shù):訂單ID。
說明:包含乘車人、出票信息的訂單詳細。

出票通知
輸入?yún)?shù):訂單ID、成功or失敗標(biāo)志、預(yù)收款金額、實際金額。
說明:出票成功時提供實際出票金額,差額需要退回給用戶。當(dāng)出現(xiàn)姓名與系統(tǒng)默認不一致、行程沖突、限制高消費等情況時,出票失敗,需要把錢退回給購票用戶。