江湖发奖平台

平台介绍

一个好的活动营销不仅能够吸引用户的注意力,成功的拉新、引流、转化,还能传递出品牌的核心价值,进而提升品牌的影响力。因此,越来越多的产品以及品牌重视营销活动。 往往好的营销活动都会涉及给用户发放奖励。江湖发奖平台搭建的初衷,就是希望为客户解决活动奖励发放中遇到的各种问题。如奖品单一,丰富度不够,难以吸引用户;奖品发放时资金流复杂,各方环节很难打通,成本高企;奖品履约困难,售后环节无法把控,用户体验差,客诉繁多等。 江湖发奖平台,依托京东强大的供应链及物流体系,可为用户提供丰富的奖品选择,成熟的资金流管理,完备的履约能力,一经推出,即受到广大客户的欢迎和推崇。

平台架构图

平台能力

目前江湖发奖平台主要分类四大类:

1、江湖订单履约:主要功能:用来履约可售卖商城商品、可售卖中台优惠券、可售卖虚拟权益

2、京东内部平台履约:主要功能:用来履约京东内部京豆、金贴、小金库红包、东券等

3、积分平台履约:主要功能:用来发放自建积分

4、发奖平台履约:主要功能:用来发放江湖自建核销类商品

接入方式

目前支持网关方式接入,遵循OAuth2.0鉴权模式

具体步骤:

1.按照接口服务要求获取accessToken

2.通过获取到的accessToken按照文档中提供的签名算法来签名并调用服务

主要接口说明

1.获取accessToken

接口描述:获取accessToken

注:token的有效性为expiresIn秒,每次调用都会刷新token,调用方可以调用并保存到本地。

接口地址:getUranusAccessToken

线上地址:https://ms.jr.jd.com/gw/generic/zc/h5/m/getUranusAccessToken

请求:

字段 字段说明 类型 必填 说明
customerId 江湖用户id String 江湖用户id
appKey 江湖用户授权appKey String 江湖用户授权appKey
appSecret 江湖用户授权appSecret String 江湖用户授权appSecret
version 版本 String 版本号,默认为1.0

响应:

字段 字段说明 类型 说明
code 响应码 String 错误码:SUCCESS("00000", "成功"), SYSTEM_ERROR("10000", "系统错误"), UNAUTHORIZED("10100", "权限不足")PARAM_ERROR("10200", "请求参数错误"), PARAM_NOT_NULL("10201", "参数必填"), PARAM_NOT_SUPPORT("10502", "不支持的参数")
msg 响应信息 String 错误信息
status 是否调用成功 boolean true:接口调用成功,false:接口调用失败
data 返回数据 Map<String,Object>

data:

字段 字段说明 类型 说明
accessToken 授权码 String 令牌
expiresIn 令牌时间 Long 令牌有效时间, 单位秒 ,目前是7200秒(即2小时)

2.发放奖励(授权接口)

接口描述:发放奖励

接口地址:rewardPrizeExport

线上地址:https://ms.jr.jd.com/gw/generic/zc/h5/m/rewardPrizeExport

请求:

字段 字段说明 类型 必填 说明
jhAppKey 江湖appKey String 江湖appKey
version 版本号 String 版本号 default:1.0
customerId 江湖商户账号 String 江湖商户账号
shopId 江湖店铺id String 江湖店铺id
activityCode 江湖发奖活动编码 String 江湖发奖活动编码
customerNo 用户唯一标识 String
customerType 用户类型 Integer 1:pin
pin 京东用户pin String 京东用户pin
productCode 江湖商品编号 String 江湖商品编号
amount 发放数量 BigDecimal 发放数量
prizeRewardType 奖励发放方式 不传走默认的发奖方式 Integer 1:直接发奖,2:需要领取
charegeAccount 充值手机号 String 充值手机号
addressDto 收货地址 Object 实物商品必传,商城addressId
requestNo 防重标识 String 外部防重标识
jhBizLine 江湖业务来源 String
jhGroupId 江湖商品组 String
accessToken accessToken String
sign sign值 String

AddressDto:

字段 字段说明 类型 必填 说明
addressId 地址ID Long

响应:

字段 字段说明 类型 说明
code 响应码 String 错误码:SUCCESS("00000", "成功"), SYSTEM_ERROR("10000", "系统错误"), UNAUTHORIZED("10100", "权限不足")PARAM_ERROR("10200", "请求参数错误"), PARAM_NOT_NULL("10201", "参数必填"), PARAM_NOT_SUPPORT("10502", "不支持的参数")
msg 响应信息 String 错误信息
status 是否调用成功 boolean true:接口调用成功,false:接口调用失败
data 返回数据 Map<String,Object>

data:

字段 字段说明 类型 说明
prizeCode 奖励编码 String
prizeType 奖励类型 String 1:星辰直充权益;2:星辰卡密权益;3:账户待领取小金库红包;4:京东金融小金库红包;5:京东金融京贴;6:京东金融金币;7:京东京豆;8:京东实物商品;9:优惠券;10:京东实物商品-需支付;11:星辰积分;12:核销自建券;
prizeName 奖励名称 String
prizeImage 奖励图片 String
prizeDesc 奖励描述 String
prizeAvaliStartTime 奖励生效开始时间 Date
prizeAvaliEndTime 奖励生效结束时间 Date

订单奖励查询服务(授权接口)

接口描述:订单奖励查询服务

注:这里的奖励支持系统待领取/已领取范围内的产品

接口地址:queryPrizeOrder

线上地址:https://ms.jr.jd.com/gw/generic/zc/h5/m/queryPrizeOrder

请求:

字段 字段说明 类型 必填 说明
jhAppKey 江湖appKey String 江湖appKey
version 版本号 String 版本号 default:1.0
customerId 江湖商户账号 String 江湖商户账号
pin 京东用户pin String 京东用户pin
prizeCode 奖励编码 String 奖励编码
accessToken accessToken String
sign sign值 String

响应:

字段 字段说明 类型 说明
code 响应码 String 错误码:SUCCESS("00000", "成功"), SYSTEM_ERROR("10000", "系统错误"), UNAUTHORIZED("10100", "权限不足")PARAM_ERROR("10200", "请求参数错误"), PARAM_NOT_NULL("10201", "参数必填"), PARAM_NOT_SUPPORT("10502", "不支持的参数")
msg 响应信息 String 错误信息
status 是否调用成功 boolean true:接口调用成功,false:接口调用失败
data 返回数据 Map<String,Object>

data:

字段 字段说明 类型 说明
customerId 江湖商户id String
shopId 江湖店铺id String
customerNo 用户唯一标识 String
customerType 用户类型 String
prizeCode 奖励编码 String
prizeType 奖励类型 String 1:星辰直充权益;2:星辰卡密权益;3:账户待领取小金库红包;4:京东金融小金库红包;5:京东金融京贴;6:京东金融金币;7:京东京豆;8:京东实物商品;9:优惠券;10:京东实物商品-需支付;11:星辰积分;12:核销自建券;
prizeName 奖励名称 String
prizeImage 奖励图片 String
prizeDesc 奖励描述 String
productCode 商品编码 String 江湖商品编码/商城SKU
productType 商品类型 String
productBussinessLine 商品业务线 String
prizeStatus 奖励状态 Integer 1:未领取;2:领取中;3:已领取;4:人工处理;
prizeAvaliStartTime 奖励生效开始时间 Date
prizeAvaliEndTime 奖励生效结束时间 Date
prizeRewardTime 奖励发放时间 Date
prizeRewardSucTime 奖励成功领取时间 Date
rewardOrderNo 奖励成功领取时间 Date
scOrderNo 江湖订单号 String
payStatus 支付状态 Integer 0:未支付;1:已支付;2:已退款;3:退款中;
payAmount 需要支付金额 BigDecimal
payTime 支付时间 Date
activityCode 活动编码 String
outRequestNo 外部请求单号 String

响应数据:

{
    "code":"00000",
    "data":{
        "prizeInfo":{
            "customerId":"C1007419908",
            "customerNo":"jd_67d1caf826454",
            "customerType":1,
            "prizeAvaliEndTime":"2020-10-01 10:05:06",
            "prizeAvaliStartTime":"2020-09-01 10:05:06",
            "prizeCode":"83c490ecad63438e9a96f88a8a478944",
            "prizeDesc":"使用说明:获得电子抵用券券号后,请登录n+官网,将所需的蛋糕“加入购物车”,在结算页面“使用优惠”中,选择“优惠券”,输入券码并确认,即可享受优惠。蛋糕预定和改期至少需提前24小时。友情提示:小情歌:https://m.npluscake.com/detail?uid=109607追光者:https://m.npluscake.com/detail?uid=109603",
            "prizeImage":"https://img10.360buyimg.com/jrasset/jfs/t1/141459/7/2995/7350/5f0eb8cbE6612b598/5487f0d2a8249f0d.jpg",
            "prizeName":"诺心蛋糕100元优惠券",
            "prizeRewardSucTime":"2020-09-01 10:05:08",
            "prizeRewardTime":"2020-09-01 10:05:06",
            "prizeStatus":3,
            "prizeType":"2",
            "productBussinessLine":"011",
            "productCode":"1845834413675",
            "rewardOrderNo":"UR2020090110050050600",
            "scOrderNo":"4000227394757252",
            "shopId":"1000_C1007419908"
        },
        "virtualGoodsOrder":{
            "orderInfo":{
                "businessLine":"011",
                "cardInfo":{
                    "assetGrantSerNo":"AG-200901-296693-10380",
                    "assetName":"诺心蛋糕100元优惠券",
                    "cardCodeAndPwdJson":{
                        "cardCode":"LNP5H9ZUKO66PB4100",
                        "cardPwd":null
                    },
                    "downstreamSerialNo":"AU-ffe4bbb9-86d5-40b8-9fb2-2263ba115383",
                    "grantState":1,
                    "message":"0000成功,权益系统返回code:1,msg:成功,",
                    "orderAmount":"0.00",
                    "orderNo":"AO-20200901100506-295333",
                    "orderSource":"jddx",
                    "orderState":99,
                    "sku":500000536,
                    "skuGrantType":2,
                    "sourceSerNo":"4000227394757252",
                    "state":1
                },
                "createOrderDate":"2020-09-01 10:05:06",
                "extMap":{
                    "orderAmount":"0.0"
                },
                "goodsInfo":{
                    "afterSaleDesc":"虚拟商品,非质量问题不退不换",
                    "amount":"0.0000",
                    "apiInv":20000,
                    "assetDesc":"活动时间:即日起-9月30日(订购并完成配送)用户福利:凭券在n+手机官网:https://m.npluscake.com,n+微商城(公众号:莺家蛋糕)上购买小情歌、追光者享受立减100元优惠。活动细则:1、本券适用于诺心所有可配送范围;(包括上海、杭州、苏州、昆山、无锡、宁波、南京、嘉兴、绍兴,天津,北京,成都12个城市的城区)2、本优惠仅限购买小情歌、追光者蛋糕的任意规格;3、同一订单仅限使用一张优惠券;4、本券不退换、不兑现、不找零,抵扣部分不开具发票;5、配送范围以及收费标准以下单信息为准;6、此优惠不与其他优惠同享,蛋糕券用户不参加;",
                    "assetState":5,
                    "businessLine":"011",
                    "cardType":2,
                    "cardVerification":0,
                    "crossedPrice":"0.00",
                    "description":"使用说明:获得电子抵用券券号后,请登录n+官网,将所需的蛋糕“加入购物车”,在结算页面“使用优惠”中,选择“优惠券”,输入券码并确认,即可享受优惠。蛋糕预定和改期至少需提前24小时。友情提示:小情歌:https://m.npluscake.com/detail?uid=109607追光者:https://m.npluscake.com/detail?uid=109603",
                    "firstCatecode":"89",
                    "fourthCatecode":"0",
                    "grantType":2,
                    "id":3644610,
                    "imgApp":"https://img10.360buyimg.com/jrasset/jfs/t1/141459/7/2995/7350/5f0eb8cbE6612b598/5487f0d2a8249f0d.jpg",
                    "imgWeb":"https://img10.360buyimg.com/jrasset/jfs/t1/141459/7/2995/7350/5f0eb8cbE6612b598/5487f0d2a8249f0d.jpg",
                    "invType":19986,
                    "isDistribution":1,
                    "isLbsSku":0,
                    "isShopping":0,
                    "isVirtual":0,
                    "onsaleFlag":2,
                    "pic":"http://img10.360buyimg.com/jrasset/jfs/t1/141459/7/2995/7350/5f0eb8cbE6612b598/5487f0d2a8249f0d.jpg",
                    "price":"0.00",
                    "productCode":"1845834413675",
                    "productName":"诺心蛋糕100元优惠券",
                    "salesPrice":"0.0000",
                    "secondCatecode":"0",
                    "showPrice":"100",
                    "skuId":"500000536",
                    "stockNum":20000,
                    "storesCount":0,
                    "thirdCatecode":"0",
                    "type":"0",
                    "upLineTime":"2020-07-15 16:05:54",
                    "validatyEndTime":"2020-09-30 00:00:00",
                    "validatyStartTime":"2020-07-15 00:00:00",
                    "validatyType":1
                },
                "orderAmount":"0.0",
                "orderNo":"4000227394757252",
                "orderStatus":510,
                "payStatus":200,
                "pin":"j***4",
                "productId":1845834413675,
                "skuId":"500000536"
            }
        },
        "entityGoodsOrder":{
            "benefitAmount":"1.0",
            "orderNo":"4000233224366606",
            "receiverName":"*江",
            "mobile":"150****8040",
            "createDateStr":"2020-09-10 15:52:01",
            "orderStatus":210,
            "list":[
                {
                    "attr":"",
                    "businessNo":"UR202009***5520000758",
                    "orderNo":"4000233224366606",
                    "picture":"jfs/t1/147185/16/2646/58358/5f099350E29cb6361/3dbd31c52cef4a9f.jpg",
                    "productName":"凝点 抽纸巾整箱小包婴儿原木抽纸酒店商用卫生纸实惠装家用面巾纸饭店3层200张/包 单包抽纸巾(小包)",
                    "quantity":1,
                    "senceId":"A1234567890",
                    "skuGroupId":0,
                    "skuId":1845834467939
                }
            ],
            "orderChannel":24,
            "points":"1.00",
            "receiverAddress":"北京大兴*********23号楼5单4层401",
            "businessNo":"UR202009***5520000758",
            "orderAmount":"0.0",
            "isMaterial":false,
            "payStatus":300,
            "platformSource":12
        }
    },
    "msg":"成功",
    "status":true,
    "success":true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
最后更新: 9/10/2021, 4:09:51 PM