星灿接收服务发放信息
[TOC]
简要描述
合作方调用该接口进行服务商品的实时发放,如果校验通过,实时返回成功,星灿会给客户对应的手机号码发送一条短信,引导查看和使用服务。
请求URL
测试环境 https://iosapipre.cnsuning.com/servicegoodsgrant?MerchantNo=申请分配&sign=xxx 生产环境 https://iosapi.suning.com/servicegoodsgrant?MerchantNo=申请分配&sign=xxx
请求方式
- POST
参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
MerchantNo | 是 | string | 接入商户号,由星灿分配 |
MerchantOrderNo | 是 | string | 商户侧唯一订单号;如果同一个订单号重复请求,则会幂等返回上一次的结果 |
ServiceGoodsCode | 是 | string | 服务商品编码,联调时由星灿提供 |
MerchantSalesPrice | 是 | string | 在合作方前台服务销售的价格,以分为单位;如果是商户集采赠送顾客,该值可传0 |
MerchantSettlementPrice | 是 | string | 合作方商户给星灿的服务结算价,以分为单位;如果是免费服务,该值可传0 |
MerchantMemberNo | 是 | string | 商户侧会员号 |
MemberMobile | 是 | string | 客户手机号 |
MemberName | 否 | string | 客户姓名;针对需要实名发放的服务,姓名、身份证号必传 |
MemberCardNo | 否 | string | 客户身份证号 |
MemberAddress | 否 | string | 客户服务地址,针对需要上门进行的服务,如有客户家庭地址信息,可传 |
请求示例
{
"MerchantNo": "50000000",
"OrderNo": "2023051648444549",
"GoodsCode": "FW1201",
"SalesPrice": "500",
"SettlementPrice": "100",
"MerchantMemberNo": "RY00311889",
"MemberMobile": "167651557577" ,
"MemberName": "王小二" ,
"MemberCardNo": "210302199010101010" ,
"MemberAddress": "江苏省南京市苏宁大道1号苏宁总部" ,
}
返回参数说明
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
Code | 是 | string | 500失败;200成功;服务发放成功后,会提供服务详情地址 |
Message | 否 | string | 失败原因 |
LinkUrl | 否 | string | 服务详情H5 url |
AppId | 否 | string | 小程序appid |
AppletUrl | 否 | string | 服务详情小程序path路径 |
返回示例
{
"Code": "200",
"message": "",
"LinkUrl": "https://issm.snisc.cn/secret/myBenefit.htm",
"AppId": "wx80ed3c0c3fc7aafb",
"AppletUrl": "pages/product/bx/myInst/myInst",
}
备注
- 安全机制见[公共说明](https://www.showdoc.com.cn/snisc/9805767650650643 "公共说明")