SCTT开放平台

请求包体：

{
    "merchant_id":287729,
    "request_time":"2023-02-11 11:48:00",
    "sign":"D19A61DBE64BA6CFB547855F216E0201",
    "hotelUuid":"00d507f7-ca63-43b1-b1ac-5c09ea0ac71c",
    "booker":{
        "last_name":"test",
        "first_name":"test",
        "email":"12345678@qq.com",
        "mobile":"+86 18823456789"
    },
    "data":{
        "trade_number":"12345678000",
        "multiRoomRequest":{
            "arrival":"2023-03-21",
            "departure":"2023-03-23",
            "cityCode":"SYD",
            "passengerCountryOfResidence":"CN",
            "nationality":"CN"
        },
        "transactionInformation":{
            "currency":"AUD",
            "totalAmount":1164
        },
        "hotelBookingRoomDetails":[
            {
                "guestNames":[
                    {
                        "firstName":"bb",
                        "lastName":"aa",
                        "title":"Mr"
                    },
                    {
                        "firstName":"cc",
                        "lastName":"aa",
                        "title":"Mr"
                    }
                ],
                "roomBookingInfo":{
                    "roomBookingUuid":"30878618-998b-404f-9ef6-2fd5b59511a1"
                },
                "rooms":1,
                "childrenAges":"",
                "numberOfAdults":2,
                "numberOfChildren":0,
                "selectedMealsPlan":{
                    "childBreakfastPrice":60,
                    "adultBreakfastPrice":60,
                    "provider":"EBOOKING",
                    "childAgeFrom":0,
                    "childAgeTo":12,
                    "currency":"AUD",
                    "breakfastType":"Breakfast",
                    "breakfastId":"91467096-6389-40f6-86ab-634a47ea28d3",
                    "providerInfo":null
                }
            }
        ]
    }
}

参数说明：

参数	必须	类型	说明
merchant_id	是	bigint	商户编号
request_time	是	string	请求时间,格式：“yyyy-MM-dd HH:mm:ss”
sign	是	string	签名
hotelUuid	是	string	酒店编码
booker	是	object	预订人信息
- last_name	是	string	英文姓
- frist_name	是	string	英文名
- email	是	string	邮箱
- mobile	是	string	电话
data	是	object	预定酒店参数
- trade_number	否	string	商户订单编号
- multiRoomRequest	是	object	基本请求信息实体
- - arrival	是	string	入住日期，日期格式：yyyymm- dd
- - departure	是	string	离店日期，日期格式：yyyymm- dd。
- - cityCode	是	string	城市编码
- - passengerCountryOfResidence	是	string	入住人员的居住国 (ISO二位国家代码如：CN，AU，NZ)
- - nationality	是	string	入住人员的国籍 (ISO二位国家代码如：CN，AU，NZ)
- transactionInformation	是	object	支付方式实体
- - currency	是	string	币种，目前支持使用澳币（AUD）和美元(USD)
- - totalAmount	是	float	支付金额
- hotelBookingRoomDetails	是	array[object]	房间住客信息，每个房间至少一个人
- - guestNames	是	array[object]	住客列表，此列表长度必须与房间数一致。且住客姓名不能重复
- - - firstName	是	string	住客名字。其规则为：1. 必须使用英文字母； 2. 至少两个字符；3. 最大不超过20个字符
- - - lastName	是	string	住客姓氏。其规则为：1. 必须使用英文字母； 2. 至少两个字符；3. 最大不超过20个字符
- - - title	是	string	住客称呼，可选值为：'Mr','Ms','Mrs'
- - roomBookingInfo	是	object	费率标识的唯一对象，在获取房间信息时可以获得此对象，需要复制到此请求中
- - - roomBookingUuid	是	string	费率标识
- - rooms	是	None	预定的房间数量
- - childrenAges	是	string	儿童年龄列表，如果 “numberOfChild ren”字段设置了大于0的值，此字段需要以逗号分隔的形式给出儿童年龄的列表。比如随行两名儿童，此字段需要写入 “3,5”。年龄的范围为：0-16岁。
- - numberOfAdults	是	number	入住成人数量，必须大于1
- - numberOfChildren	是	number	入住儿童数量，需大于等于0
- - selectedMealsPlan	否	object	如果用户选择了可选早餐，需要将 “检索房型信息接口”返回值的 “ optionalMealsPla n”对象完全复制到这个对象里
- - - childBreakfastPrice	否	number	儿童早餐价格
- - - adultBreakfastPrice	否	number	成人早餐价格
- - - provider	否	string	供应商标识
- - - childAgeFrom	否	number	计算儿童年龄区间的最小值
- - - childAgeTo	否	number	计算儿童年龄区间的最大值
- - - breakfastType	否	string	早餐类型（文字描述）
- - - breakfastId	否	number	早餐编码
- - - providerInfo	否	string	null
transactionType	否	string	支付方式，目前仅支持转账方式（BANK_TRANSFER）

返回结果：

{
    "code": 0,
    "msg": "ok",
    "data": {
        "status": 0,
        "payload": {
            "confirmationNumber": "2916671020",
            "trade_number": "12345678039",
            "status": "BOOKED"
        }
    }
}

参数说明：

参数	类型	说明
code	int	状态码
msg	string	接口返回信息
- data	object	接口返回数据
- status	number	0为成功，其他值表示预订失败
- payload	object	酒店预定信息
- - status	string	预订的状态，BOOKED：预订成功；PENDING: 等待确认; FAILED: 预订失败；
- - confirmationNumber	string	订单确认号
- - trade_number	string	用户订单编号

状态码说明：

状态码	说明
0	预订成功
7001	报文错误
7002	签名错误
7003	商户不存在
7004	商户暂未开通API权限
7005	商户信息未完善
7006	商户不存在主账号
7007	额度不足
7008	房间入住人信息错误
7009	酒店信息不存在
7010	房型不存在
7011	费率检查错误
7012	未知错误
7013	预定失败