星灿接收服务发放信息
[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 "公共说明")