目录
使用场景：
调用此接口查询业务订单
接口编号：alipay.open.mini.order.query
请求参数（bizdata）：
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| out_order_id | 商户订单号 |
由商家自定义 64个字符以内 仅支持字母、数字、下划线且需保证在商户端不重复 |
否 | String(32) |
out_order_id和order_id必填其一 建议优先使用order_id |
| order_id | 交易组件订单号 |
【描述】交易组件订单号； order_id和out_order_id二选一 【示例值】2015042321001004720200028594 |
否 | String(128) | |
| user_id | 买家支付宝用户 | 否 | String(32) | user_id和open_id两者必填其一 | |
| open_id | 支付宝用户open_id | 否 | String(128) |
返回参数（bizdata）：
| 参数 | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| order_id |
交易组件 订单号 |
【描述】平台订单号 【示例值】202305100150230000000152 |
否 | String(128) | |
| create_time | 创建时间 |
【描述】创建时间，yyyy-MM-dd HH:mm:ss 【示例值】2023-03-23 12:00:00 |
否 | string(64) | |
| out_order_id |
商家自定 义订单号 |
【描述】商家自定义订单ID (字符仅支持下划线字母数字，长度小于128个字符） 【示例值】tqshajkk1163937ZZ |
否 | string(32) | |
| contact_info |
联系人信 息 |
【描述】买家联系人信息 本地生活商品使用 详见本接口下方数组类字段说明： contact_info的明细字段 |
否 | object[contact_info] | |
| stage_pay_plans |
阶段付款 计划 |
【描述】阶段付款计划列表 详见本接口下方数组类字段说明： stage_pay_plans的明细字段 |
否 | object[stage_pay_plans] | |
| user_id |
蚂蚁统一 会员ID |
否 | string(32) |
user_id和 open_id 二选一必传 |
|
| open_id |
用户 openId |
否 | string(128) | ||
| trade_no | 支付单号 |
【描述】支付单号，支付成功后会该字段会有值 【示例值】202304121231490902 |
是 | string(64) | |
| order_detail |
订单详细 数据 |
【描述】订单详细数据 详见本接口下方 数组类字段说明： order_detail的明细字段” |
是 | object[order_detail] | |
| status | 订单状态 |
【描述】订单状态 【枚举值】 订单创建: TRADE_CREATED 等待支付: WAIT_PAY 超时取消: TIMEOUT_CLOSED 支付成功: PAID 部分发货: PARTIAL_DELIVERED 全部发货: DELIVERED 确认收货: RECEIVED_CONFIRM 全部退款: REFUND_CLOSED CONFIRMED: 已确认 CANCELLED: 预约失败 TO_BE_CHK_IN: 待入住 CHECK_IN: 已EC入住 HAVE_STAY: 已续住 TO_CHECK_OUT: 待退房 CHECK_OUT: 已退房 FINISHED: 已完结 GIVE_BACK: 已归还 MERCHANT_CONFIRMED: 商户已确认 |
否 | string(64) | |
| delivery_detail | 配送信息 |
【描述】配送信息 详见本接口下方 数组类字段说明： delivery_detail的明细字段 |
是 | object[delivery_detail] | |
| path |
订单详情 页路径 |
【描述】商家小程序对应的订单详情页路径地址 【示例值】/pages/index/index?orderId=10190608609185 |
是 | string(128) | |
| refund_info | 退款信息 |
【描述】退款信息 详见本接口下方 数组类字段说明： refund_info的明细字段 |
是 | object[refund_info] | |
| default_receiving_address |
默认退货 地址 |
【描述】默认退货地址 详见本接口下方 数组类字段说明： default_receiving_address的明细字段 |
是 | object[default_receiving_address] | |
| address_info | 收货地址 |
【描述】收货地址 详见本接口下方 数组类字段说明： address_info的明细字段 |
是 | object[address_info] | |
| merchant_biz_type | 订单类型 |
【枚举值】 电商购物: KX_SHOPPING 团购劵: GROUP_SECURITIES 虚拟商品: VIRTUAL_RECHARGE |
是 | string(64) | |
| receive_time |
确认收货 时间 |
【描述】确认收货时间 【示例值】2023-04-20 12:37:04 |
是 | string(64) | |
| settle_type | 账期标识 |
【描述】结算方式 【枚举值】 即时到账: normal 账期结算: extended 【示例值】normal |
是 | string(64) | |
| booking_info |
酒店预订 信息 |
【描述】酒店预订信息 详见本接口下方 数组类字段说明： booking_info的明细字段 |
是 | object[booking_info] | |
| shop_info | 门店信息 |
【描述】门店信息 详见本接口下方 数组类字段说明： shop_info的明细字段 |
是 | object[shop_info] |
数组类字段说明
1.contact_info联系人信息的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| phone_number | 手机号 |
【描述】联系人手机号 【示例值】132******** |
是 | string[1,64] | |
| contact_name | 联系人姓名 |
【描述】联系人姓名 【示例值】张三 |
否 | string[1,64] | |
| encryption_content | 联系人信息加密内容 |
【描述】加密内容 创单时由团购插件上传 内容为手机号加密内容 |
是 | string(512) |
2.stage_pay_plans的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| stage_no | 阶段编码 |
【描述】阶段付款计划阶段编号 标识当前计划处于第几阶段 起始值为1 多阶段需保证阶段编号递增 【示例值】1 |
否 | number[1,36] | |
| stage_pay_plan_infos | 计划信息列表 | 【描述】阶段付款计划详情列表 | 否 | object[stage_pay_plan_infos] |
2-1）stage_pay_plan_infos的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| plan_pay_no | 计划付款编号 |
【描述】阶段计划付款编号 标识第几次或第几期付款 起始值为1 多个计划需保证编号递增 【示例值】1 |
否 | number[1,36] | |
| plan_pay_price | 计划付款金额 |
【描述】阶段付款计划付款金额 单位：元 精确到小数点后两位 【示例值】100.00 |
否 | price[0,10000000] | |
| plan_pay_time | 计划付款时间 |
【描述】阶段付款计划付款时间 多个计划需保证付款时间递增 匹配格式yyyy-MM-dd HH:mm:ss的date类型 【示例值】2024-04-10 12:00:00 |
否 | date |
3.Order_detail的明细字段
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| item_infos | 商品详细信息 | 【描述】商品详细信息 | 否 | array[object] | |
| price_info | 价格详细信息 | 【描述】价格详细信息 | 否 | object[price_info] | |
| pay_info | 支付信息 | 【描述】支付信息 | 是 | object[pay_info] | |
| promo_apply_info | 优惠申领信息 | 是 | object[promo_apply_info] |
3-1）item_infos的明细字段
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| goods_name | 商品名称 |
【描述】商品名称 【示例值】商品名称1 |
否 | string[1,256] | |
| item_cnt | 商品数量 |
【描述】商品数量 【示例值】5 |
否 | string[1,10] | |
| sale_price | 商品单价 |
【描述】商品单价 单位：元, 精确到小数点后两位 【示例值】88.88 |
否 | string[1,11] | |
| goods_id |
商品的编 号 |
【描述】提报支付券优惠时的商品id 用于关联使用支付券 需要和支付券上绑定商品goods_id相同 如果不使用支付券 该字段传入商品最小粒度的商品id 如:若商品有 sku 粒度，则传商品 sku 粒度的id 【示例值】1234567 |
否 | string[1,32] | |
| out_item_id |
商户商品 ID |
【描述】商户侧商品id 用于公域场景结算 会影响主播归因。 私域场景无需传入 公域场景未传入会影响后续结算 【必选条件】公域场景使用必传 订单前置判断接口返回的sourceId不为空 【示例值】123 |
是 | string[1,64] | |
| out_sku_id |
商户商品 sku_id |
【描述】商户侧商品sku_id 用于公域场景结算 如果商品有多个sku 需要传入准确的sku_id 无sku时不需要传入 【必选条件】 公域场景下 商品提报过多个out_sku_id时必传 【示例值】34567576565656 |
是 | string[1,64] | |
| sale_real_price |
商品实际 单价 |
【描述】商品真实单价 单位：元 精确到小数点后两位, 有优惠信息时需要传入 优惠方式sale_real_price与item_discount二选一 sale_real_price使用场景：商品有单价优惠 传入商品实际成交单价 item_discount 使用场景： 同时购买多件商品时存在优惠 传入优惠总额 优惠计算参考： 资金平衡校验 sale_real_price 使用场景： 商品有单价优惠 传入商品实际成交单价 item_discount 使用场景： 同时购买多件商品时存在优惠 传入优惠总额 优惠计算参考： 资金平衡校验 【必选条件】sale_real_price使用场景： 商品有单价优惠，传入商品实际成交单价 【示例值】68.88 |
是 | string[1,11] | |
| item_discount |
商家商品 优惠金额 |
【描述】单位元有优惠信息时需要传入 优惠方式sale_real_price与item_discount二选一 sale_real_price使用场景： 商品有单价优惠 传入商品实际成交单价 item_discount使用场景： 同时购买多件商品时存在优惠 传入优惠总额优惠 计算参考：文档中资金平衡校验 【必选条件】item_discount使用场景： 同时购买多件商品时存在优惠 传入优惠总额 【示例值】1.00 |
是 | string[0,10] | |
| image_material_id |
商家商品 素材ID |
【描述】商品图片 用于小程序订单中心展示 可通过 alipay.merchant.item.file.upload 接口上传素材获取素材id 默认使用已上报的商品库素材信息 【必选条件】已上报的商品可不传入 未上报商品库需传入 为空会导致订单展示异常 【示例值】201901010050220000000000 |
是 | string[1,256] | |
| item_installment_info |
商品分期 信息 |
【描述】商品分期信息 【必选条件】分期代扣商品必填 |
是 | object[item_installment_info] | |
| goods_type | 商品类型 |
【描述】商品类型 【枚举值】 票务本地商品: TICKET 虚拟商品: VIRTUAL 【示例值】VIRTUAL |
是 | string[1,36] | |
| rent_info | 租金信息 | 租金信息，租赁商品特有 | 是 | object[rent_info] | |
| body |
商品描述 信息 |
【描述】商品描述信息 【示例值】商品是法国生产 |
是 | string[1,1000] | |
| effective_dates | 价格日历 | 【描述】价格日历 | 是 | object[effective_dates] | |
| ticket_info | 票务信息 | 【描述】演出票务信息 | 是 | object[ticket_info] | |
| activity_info | 活动信息 | 【描述】活动信息 | 是 | object[activity_info] |
3-1-1）item_installment_info的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| period_num | 总分期数 |
【描述】分期商品对应的总分期数 【示例值】12 |
否 | number[1,36] | |
| period_max_price |
每期最大 金额 |
【描述】分期商品每期金额不固定时 请填入该字段 分期时分期金额会与该字段进行比较 单位为元 【示例值】100.00 |
否 | price[0.1,999999] |
period_max_price period_price 二选一传入 |
| period_price | 每期金额 |
【描述】分期商品每期金额固定时 请填入该字段 分期时分期金额会与该字段进行比较 单位为元 【示例值】50.00 |
否 | price[0.1,999999] | |
| period_num | 总分期数 |
【描述】分期商品对应的总分期数 【示例值】12 |
否 | number[1,36] | |
| period_max_price |
每期最大 金额 |
【描述】分期商品每期金额不固定时 请填入该字段 分期时分期金额会与该字段进行比较 单位为元 【示例值】100.00 |
否 | price[0.1,999999] | |
| period_price | 每期金额 |
【描述】分期商品每期金额固定时 请填入该字段 分期时分期金额会与该字段进行比较 单位为元 【示例值】50.00 |
否 | price[0.1,999999] |
3-1-2）rent_info的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| rent_start_time | 租期开始时间 |
【描述】租期开始时间 匹配格式yyyy-MM-dd HH:mm:ss的date类型 【必选条件】在创建订单接口的情况下 订单模型类型为STANDARD_RENT必填 【示例值】2023-11-01 12:00:00 |
是 | date | |
| rent_end_time | 租期结束时间 |
【描述】租期结束时间 匹配格式yyyy-MM-dd HH:mm:ss的date类型 【必选条件】在创建订单接口的情况下 订单模型类型为STANDARD_RENT必填 【示例值】2023-11-01 12:00:00 |
是 | date | |
| buyout_price | 买断价 |
【描述】买断价，单位元 【示例值】2000.00 |
是 | string[1,100] | |
| deposit_price | 押金金额 |
【描述】押金金额，单位元 【示例值】100.00 |
是 | string[0,100] |
3-1-3）effective_dates的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| date | 价格日期 |
【描述】价格日期 yyyyMMdd 【示例值】20211101 |
是 | string[0,1024] | |
| price | 商品单价 |
【描述】商品单价，单位元 【示例值】20.00 |
是 | string[0,256] |
3-1-4）ticket_info的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| ticket_id | 票编码ID |
【描述】票编码ID，票的唯一标识 【示例值】 20240222123058189321 |
否 | string[1,32] | |
| ticket_type | 票类型 |
【描述】票类型 【枚举值】 实体票: PHYSICAL 电子票: ELECTRONIC 【示例值】ELECTRONIC |
否 | string[1,16] | |
| event_id | 场次ID |
【描述】场次唯一标识 【示例值】 202402221230581892322 |
否 | string[1,32] | |
| event_name | 场次名称 |
【描述】场次名称 【示例值】2024年4月18日场次 |
否 | string[1,64] | |
| event_start_time | 场次开始时间 |
【描述】场次开始时间 匹配格式yyyy-MM-dd HH:mm:ss的date类型 【示例值】2021-11-23 20:30:00 |
否 | date | |
| location_name | 演出位置 |
【描述】演出位置 【示例值】杭州奥体中心体育场 |
否 | string[1,64] | |
| city | 演出城市 |
【描述】演出地点所属的城市 【示例值】杭州市 |
否 | string[1,64] | |
| ticket_link | 票据链接 |
【描述】票据链接 跳转到票核销链接的地址 alipays://plapp?appId=xxx&page=xxx |
是 | string[1,512] | |
| event_end_time | 结束时间 |
【描述】场次结束时间 匹配格式yyyy-MM-dd HH:mm:ss的date类型 【示例值】2021-11-23 22:30:00 |
是 | data | |
| performance_seats | 演出座位号 |
【描述】演出座位号 【示例值】A区3排5座 |
是 | string[1,32] |
3-1-5）activity_info的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| activity_id | 活动ID |
【描述】活动编码ID，活动的唯一标识 【示例值】 20240222123058114335 |
否 | string[1,32] | |
| activity_name | 活动名称 |
【描述】活动名称 【示例值】团建轰趴套餐 |
否 | string[1,64] | |
| location_name | 地点 |
【描述】活动地点 【示例值】万达广场 |
否 | string[1,64] | |
| city | 演出城市 |
【描述】活动所在的城市名 【示例值】杭州市 |
否 | string[1,64] | |
| start_time | 开始时间 |
【描述】活动开始时间 匹配格式yyyy-MM-dd HH:mm:ss的date类型 【示例值】 2021/11/23 20:30 |
是 | date | |
| end_time | 结束时间 |
【描述】活动结束时间 匹配格式yyyy-MM-dd HH:mm:ss的date类型 【示例值】 2021/11/23 22:30 |
是 | date | |
| link | 活动票链接 |
【描述】活动票链接 【示例值】 alipays://plapp?appId=xxx&page=xxx |
是 | string[1,512] |
3-2）price_info的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| order_price | 订单金额 |
【描述】订单总价 单位：元,精确到小数点后两位 【示例值】88.88 |
否 | string[1,11] | |
| freight | 运费 |
【描述】运费 单位：元 精确到小数点后两位 【示例值】100 |
是 | string[1,9] | |
| discounted_price | 商家优惠金额 |
【描述】商家优惠金额 单位：元 精确到小数点后两位 【示例值】88.88 |
是 | string[1,11] | |
| merchant_value_price | 商家储值金额 |
【描述】商家侧储蓄卡金额 单位为元 精确到小数点后两位 【示例值】100.00 |
是 | price[0,999999999) |
3-3）pay_info的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| payment_biz_type | 支付渠道 |
【描述】订单支付渠道 空值默认为支付宝支付 【枚举值】 免费订单: FREE 【示例值】FREE |
是 | string[1,64] | |
| payment_method | 支付方式 |
【描述】支付方式 到付等特殊场景下传入 【枚举值】 到付: COUNTER 【示例值】COUNTER |
是 | string[1,64] |
3-4）promo_apply_info的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| promo_apply_summary_infos | 营销申领汇总 | 是 | object[promo_apply_summary_infos] | ||
| promo_apply_item_infos | 营销申领商品明细 |
【描述】支付方式 到付等特殊场景下传入 【枚举值】 到付: COUNTER 【示例值】COUNTER |
是 | object[promo_apply_item_infos] |
3-4-1）promo_apply_summary_infos的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| promotion_type | 优惠类型 |
【描述】营销优惠类型 【枚举值】 商品券: EXTERNAL_MERCHANT_VOUCHER 支付券/平台优惠券/红包: PROMO_VOUCHER 专享价: DISCOUNT 支付宝会员: ANT_MEMBER 消费金: CONSUME_GOLD |
是 | string(128) | |
| promotion_sub_type | 优惠子类型 |
【描述】营销优惠子类型 【枚举值】 会员积分: MEMBER_POINTS 等级价: LEVEL_PRICE |
是 | string(128) | |
| apply_amount | 优惠申领数量 |
【描述】优惠申领金额或者数量 金额时单位：分 需要根据budget_type字段区分金额和数量 【示例值】1000 |
是 | string(64) | |
| budget_type | 预算类型 |
【描述】优惠申领的预算类型 【枚举值】 数量预算: COUNT 金额预算: MONEY 【示例值】COUNT |
是 | string(64) | |
| member_level | 会员等级 |
【枚举值】 大众会员: primary 黄金会员: golden 铂金会员: platinum 钻石会员: diamond 【示例值】primary |
是 | string(16) | |
| sub_promo_infos | 子营销申领明细 |
【描述】子营销申领明细 包含子营销申领消耗的名称和数量 |
是 | object[sub_promo_infos] |
3-4-1-1）sub_promo_infos的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| sub_type_name | 消耗的子代币类型名称 |
【描述】订单消耗的子代币类型名称 【示例值】爱国福 |
是 | string(128) | |
| cost_count | 消耗的子代币数量 |
【描述】订单消耗的子代币数量 【示例值】2 |
是 | string(16) |
3-4-2）promo_apply_item_infos的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| item_id | 支付宝平台侧商品ID |
【描述】支付宝平台侧商品ID 【示例值】12200000 |
是 | string(64) | |
| sku_id | 支付宝侧商品skuid |
【描述】支付宝侧商品skuid 【示例值】123412 |
是 | string(64) | |
| promo_apply_item_detail_infos | 商品申领明细 | 是 | object[promo_apply_item_detail_infos] |
3-4-2-1）promo_apply_item_detail_infos的明细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| promotion_type | 优惠类型 |
【描述】营销优惠类型 【枚举值】 商品券: EXTERNAL_MERCHANT_VOUCHER 支付券、平台优惠券、红包: PROMO_VOUCHER 专享价: DISCOUNT 支付宝会员: ANT_MEMBER 消费金: CONSUME_GOLD 【示例值】DISCOUNT |
是 | string(128) | |
| promotion_sub_type | 优惠子类型 |
【描述】营销优惠子类型 【枚举值】 会员积分: MEMBER_POINTS 等级价: LEVEL_PRICE 【示例值】MEMBER_POINTS |
是 | string(128) | |
| apply_amount | 优惠申领数量 |
【描述】优惠申领金额或者数量 金额时单位：分 需要根据budget_type字段区分金额和数量 【示例值】1000 |
是 | string(64) | |
| budget_type | 预算类型 |
【描述】优惠申领的预算类型 【枚举值】 数量预算: COUNT 金额预算: MONEY 【示例值】COUNT |
是 | string(64) | |
| member_level | 会员等级 |
【枚举值】 大众会员: primary 黄金会员: golden 铂金会员: platinum 钻石会员: diamond |
是 | string(16) | |
| sub_promo_infos | 子营销申领明细 |
【描述】子营销申领明细 包含子营销申领消耗的名称和数量 |
否 | object[sub_promo_infos] | |
| promotion_type | 优惠类型 |
【描述】营销优惠类型 【枚举值】 商品券: EXTERNAL_MERCHANT_VOUCHER 支付券、平台优惠券、红包: PROMO_VOUCHER 专享价: DISCOUNT 支付宝会员: ANT_MEMBER 消费金: CONSUME_GOLD 【示例值】DISCOUNT |
是 | string(128) | |
| promotion_sub_type | 优惠子类型 |
【描述】营销优惠子类型 【枚举值】 会员积分: MEMBER_POINTS 等级价: LEVEL_PRICE 【示例值】MEMBER_POINTS |
是 | string(128) | |
| apply_amount | 优惠申领数量 |
【描述】优惠申领金额或者数量 金额时单位：分 需要根据budget_type字段区分金额和数量 |
是 | string(64) | |
| budget_type | 预算类型 |
【描述】优惠申领的预算类型 【枚举值】 数量预算: COUNT 金额预算: MONEY 【示例值】COUNT |
是 | string(64) | |
| member_level | 会员等级 |
【枚举值】 大众会员: primary 黄金会员: golden 铂金会员: platinum 钻石会员: diamond |
是 | string(16) | |
| sub_promo_infos | 子营销申领明细 |
【描述】子营销申领明细 包含子营销申领消耗的名称和数量 |
否 | object[sub_promo_infos] |
4.delivery_detail的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| finish_all_delivery | 发货完成标志位 |
【描述】发货完成标志位 false:未发完 true:已发完 【枚举值】 未发完: false 已发完: true 【示例值】true |
是 | string(64) | |
| delivery_list | 物流信息 | 是 | object[delivery_list] |
4-1)delivery_list的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| delivery_id | 快递公司ID | 【描述】快递公司ID | 是 | string(64) | |
| waybill_id | 快递单号 | 是 | string(32) | ||
| item_info_list | 商品信息 | 是 | object[item_info_list] |
4-1-1)item_info_lis的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| out_item_id | 商户商品ID | 是 | string(64) | ||
| out_sku_id | 商户商品sku_id | 是 | string(64) |
5.refund_info的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| refund_list | 退款记录 | 是 | object[refund_list] |
5-1）refund_list的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| status | 退款记录状态 |
【描述】退款记录状态 【枚举值】 退款成功: SUCCESS 退款中: PROCESS 退款失败: FAIL |
否 | string(64) | |
| amount | 退款金额 |
【描述】退款金额 单位：元 精确到小数点后两位 【示例值】10.0 |
是 | string(64) | |
| refund_id | 支付系统退款单号 |
【描述】支付系统退款单号 【示例值】1214412 |
是 | string(64) | |
| out_refund_id | 外部退款流水号 |
【描述】外部退款流水号 【示例值】202303250019936 |
是 | string(128) |
6.default_receiving_address默认退货地址的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| receiver_name | 收货人 |
【描述】收货人姓名 【注意事项】仅实物类电商订单需要回传收货信 【示例值】张三 |
否 | string[1,64] | |
| detailed_address | 收货地址 |
【描述】收货地址信息 【注意事项】仅实物类电商订单需要回传收货信 【示例值】中国浙江省杭州市西湖区xx小区xx号 |
否 | string[1,1024] | |
| tel_number | 联系方式 |
【描述】收货人手机号 【注意事项】仅实物类电商订单需要回传收货信 【示例值】132******** |
否 | string[1,64] | |
| receiver_zip | 收货邮编地址 |
【描述】收货邮编地址 【示例值】310006 |
是 | string[1,64] | |
| receiver_division_code | 标准城市域码 |
【描述】标准城市域码 【示例值】310006 |
是 | string[1,64] |
7.address_info收货地址的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| receiver_name | 收件人 |
【描述】收件人姓名 【注意事项】仅实物类电商订单需要回传收货信 【示例值】张三 |
否 | string(64) | |
| detailed_address | 收货地址 |
【描述】详细收货地址信息 【注意事项】仅实物类电商订单需要回传收货信 【示例值】中国浙江省杭州市西湖区xx小区xx号 |
否 | string(1024) | |
| tel_number | 联系方式 |
【描述】收件人手机号码 【注意事项】仅实物类电商订单需要回传收货信 【示例值】137***23 |
否 | string(64) |
8.booking_info酒店预定信息的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| confirm_booking_time | 确认预约时间 |
【描述】商户确认买家的预约 【必选条件】商户确认买家的预约 已确认 状态下必选； 【示例值】2023-01-11 11:00:00 |
是 | string(64) | |
| check_in_date | 入住日期 |
【描述】入住日期 【必选条件】 已入住、已续住、待退房、已退房状态下必选 【示例值】2023-01-11 |
是 | string(64) | |
| check_in_time | 入住时间 |
【描述】入住时间 【必选条件】 已入住、已续住、待退房、已退房状态下必选 【示例值】2013-12-24 11:43:23 |
是 | string(64) | |
| check_out_date | 离店日期 |
【必选条件】 已入住、已续住、待退房、已退房状态下必选 |
是 | string(64) | |
| check_out_time | 离店时间 |
【必选条件】 已入住、已续住、待退房、已退房状态下必选 |
是 | string(64) | |
| booking_time | 预约入住时间 |
【描述】预约入住时间 【必选条件】 订单创建、已确认、待入住 状态下必传 【示例值】2013-12-24 11:43:23 |
是 | string(64) | |
| have_stay_time | 续住时间 |
【描述】商户为买家办理续住的时间 【必选条件】 已续住 状态下必选 【示例值】2013-12-24 11:43:23 |
是 | string(64) | |
| room_num | 房间号 |
【描述】入住酒店房间号 【必选条件】 酒店日历房商品 已入住、待退房、已续住、已退房状态下必选 【示例值】204 |
是 | string(64) | |
| deadline | 最晚到店时间 |
【描述】最晚到店时间 【示例值】2013-12-24 11:43:23 |
是 | string(64) | |
| customer_service_mobile | 客服电话 |
【描述】客服电话 包含区号+电话号码的座机号码格式，以及手机号码格式 【示例值】0571-88888888 |
是 | string(64) | |
| refund_rule | 退改规则 |
【描述】退改规则 【示例值】阶梯退：入住前x天的x点 收取手续费：0%、30%、10%、100% |
是 | string(2048) |
9.shop_info门店信息的详细字段
| 字段ID | 字段名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| name | 门店名称 |
描述】门店名称 【示例值】门店名称 |
否 | string[0,1024] | |
| address | 门店地址 |
【描述】门店地址 【示例值】门店地址 |
否 | string[0,2048] | |
| merchant_shop_id | 商家侧门店id |
【描述】商家侧门店id 【示例值】1000 |
是 | string[0,255] | |
| alipay_shop_id | 蚂蚁侧门店id |
【描述】蚂蚁侧门店id 【示例值】 2232320180127 |
是 | string[0,255] |