1.支付(条码或扫码)、查询、撤销接口必须接入
,退款及其他接口根据商户业务需要决定是否接入。
2.当支付接口返回结果码为10003、20000时必须配合查询接口
轮训交易状态;
3.store_id、terminal_id必传!
(如果有建议必传!具体根据业务需求咨询客户经理或运营决定),方便出现问题排查。
4.系统商
商户接口中extend_params参数必传,sys_service_provider_id传系统商签约账户的PID
,格式如:
"extend_params":{"sys_service_provider_id":"2088511833207846"}
5.酒店、景区、汽车站商户goods_detail参数要求必传
!参数格式传递要求如下:
1)酒店:
主要针对系统商和中高端酒店等,一笔订单存在多个业务账单的场景。该参数传递参考样例:
[{“goods_id”:“001”,“goods_name”:“房费”,“price”:“200.00”,“quantity”:“1”},{“goods_id”:“002”,“goods_name”:“餐饮 费”,“price”:“200.00”,“quantity”:“1”},{“goods_id”:“003”,“goods_name”:“其它费用”,“price”:“200.00”,“quantity”:“1”}]
2)景区:
goods_id、body、goods_name、goods_category、quantity、price必传!并且参数值按照下面括号中描述取值,严格区分大小写。
参数名 | 参数功能描述 | 参数值 |
goods_id | 用于区分景区类型,5A、4A、乐园、其他 | 5A;4A;park;other |
Body | 该景区所属省份 | 省份中文名,如:浙江 |
goods_name | 用于区分单一景区 | 景区中文名全称 |
goods_category | 用于区分票口、园内二次消费场景 | ticket;other |
quantity | 用于传递门票数量或商品的数量 | 如:1 |
price | 传递商品单价,单位为元 | 如:200.00 |
该参数传递参考样例:
[{“goods_id”:“park”,“body”:“四川”,“goods_name”:“成都欢乐谷”,“goods_category”:“ticket”,“price”:“200.00”,“quantity”:“1”}]
store_id参数对于景区类商户要求必传!(用于判别每个消费点,赋值如:东门票口、西门票口、XX餐厅、XX纪念品店等)
。3)汽车站:
商品明细说明参数传递规则:
goods_id、body、goods_name、goods_category、quantity、price必传!并且参数值按照下面括号中描述取值,严格区分大小写。
参数名 | 参数功能描述 | 参数值 |
goods_id | 汽车站所属省份 | 省份中文名,如浙江 |
Body | 汽车站所属城市 | 城市中文名,如杭州 |
goods_name | 车站中文全称 | 汽车站中文名全称,如杭州客运中心 |
goods_category | 用于区分终端机和窗口购票 | terminal,window |
quantity | 用于传递门票数量或商品的数量 | 如:1 |
price | 传递商品单价,单位为元 | 如:200.00 |
参考样例:
[{“goods_id”:“四川”,“body”:“成都”,“goods_name”:“成都新南门车站”,“goods_category”:“terminal”,“price”:“50.00”,“quantity”:“2”}]