目录
通知具有自动重发机制，接口幂等需由对接方保证。
以下是通知重发机制：
|
第几次重试 |
与上次重试的间隔时间 |
第几次重试 |
与上次重试的间隔时间 |
|
1 |
10秒 |
9 |
7分钟 |
|
2 |
30秒 |
10 |
8分钟 |
|
3 |
1分钟 |
11 |
9分钟 |
|
4 |
2分钟 |
12 |
10分钟 |
|
5 |
3分钟 |
13 |
20分钟 |
|
6 |
4分钟 |
14 |
30分钟 |
|
7 |
5分钟 |
15 |
1小时 |
|
8 |
6分钟 |
16 |
2小时 |
5.1券核销通知
卡券（实体卡、满减券、金额券、计次券）核销时的数据通知
业务请求参数
method: allinpay.shopoint.couponService.checkNotify
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
|
|
changeId |
Integer |
是 |
核销记录编号 |
|
||
|
couponId |
Integer |
是 |
券编号 |
|
||
|
couponNo |
String |
是 |
|
券号 |
|
|
|
orderId |
Integer |
否 |
核销内部订单号 |
|
||
|
templateId |
Integer |
是 |
券模板编号 |
|
||
|
consumeAmount |
String |
是 |
核销金额 |
单位为分 |
||
|
orderNo |
String |
否 |
|
交易单号 |
|
|
|
tranNo |
String |
否 |
|
交易流水号 |
|
|
|
tranDateTime |
String |
是 |
|
核销交易时间 |
格式: yyyyMMddHHmmss |
|
|
unit |
String |
否 |
|
单位, 计次券使用 |
|
|
|
couponName |
String |
是 |
|
券名称 |
|
|
|
shopName |
String |
否 |
|
店铺名称 |
|
|
|
cardNo |
String |
否 |
|
会员卡号 |
|
|
|
publicOpenId |
String |
否 |
|
机构公众号OPENID |
|
|
|
promotionId |
Integer |
否 |
|
活动ID |
|
|
|
mobile |
String |
否 |
|
微信手机号 |
|
|
|
shopId |
Integer |
否 |
|
核券店铺ID |
|
|
|
shopCode |
String |
否 |
|
店铺号 |
|
|
|
orgId |
Integer |
否 |
|
机构ID |
|
|
|
orgName |
String |
否 |
|
机构名称 |
|
|
|
customerId |
Integer |
否 |
|
数字营销会员ID |
|
|
|
createUserId |
Integer |
否 |
|
核销人登录账号 |
|
|
|
createUserSysno |
Integer |
否 |
|
核销人ID |
|
|
|
createUserName |
String |
否 |
|
核销人姓名 |
|
|
|
outOrderId |
String |
否 |
|
核销外部订单号 |
|
|
|
financeList |
|
List |
否 |
|
财务科目列表 |
|
|
accountNo |
String |
是 |
|
财务科目号 |
|
|
|
accountTitle |
String |
是 |
|
财务科目名称 |
|
|
|
accountPriority |
Integer |
否 |
|
财务科目优先级 |
数字越小，优先级越高 |
|
|
|
String |
是 |
|
科目值 |
5.2 |
|
5.2会员注册/修改通知
业务请求参数
method: allinpay.shopoint.customerService.registerNotify(注册),
allinpay.shopoint.customerService.modifyNotify(修改)
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
|
customerId |
Integer |
是 |
会员ID |
|
|
|
mobile |
String |
是 |
|
手机号 |
|
|
cardNo |
String |
否 |
|
会员卡号 |
|
|
memberLevelId |
Integer |
是 |
会员等级 |
|
|
|
openid |
String |
否 |
微信openid |
|
|
|
name |
String |
否 |
姓名 |
|
|
|
gender |
String |
否 |
性别 |
|
|
|
nickName |
String |
否 |
昵称 |
|
|
|
birthday |
String |
否 |
生日 |
|
|
|
carLicenseNo |
String |
否 |
车牌号 |
|
|
|
refereeSysno |
Integer |
否 |
推荐人ID |
|
|
|
referee |
String |
否 |
推荐人 |
|
|
|
registerMethod |
Integer |
是 |
来源方式 |
1-顾客注册,2-POS注册,3数据导入,4-发会员卡,5-接口导入 |
|
|
registerFrom |
String |
是 |
注册来源 |
|
|
|
unionId |
String |
否 |
会员唯一ID |
|
5.3订单支付通知
业务请求参数
method: allinpay.shopoint.orderService.notify
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
||
|
reqTransCode |
String |
否 |
外部订单号ISV订单号 |
|
|||
|
orderCode |
String |
是 |
|
订单号 |
|
||
|
amount |
Integer |
是 |
|
订单原始金额 |
单位分 |
||
|
noDiscountAmount |
Integer |
是 |
|
不参与优惠抵扣金额 |
单位分 |
||
|
discountAmount |
Integer |
是 |
商户活动优惠金额 |
单位分 |
|||
|
couponAmount |
Integer |
是 |
商户卡券抵扣金额 |
单位分 |
|||
|
balanceAmount |
Integer |
是 |
钱包消费金额 |
单位分 |
|||
|
scoreAmount |
Integer |
是 |
积分抵扣金额 |
单位分 |
|||
|
subsidyAmount |
Integer |
是 |
银行活动优惠金额 |
单位分 |
|||
|
giveAmount |
Integer |
是 |
赠送金额 |
单位分 |
|||
|
paymentMethod |
String |
是 |
支付方式 |
银行卡、微信、支付宝、云闪付、现金、全抵扣 |
|||
|
paymentAmount |
Integer |
是 |
支付金额 |
单位分 |
|||
|
transType |
Integer |
是 |
|
交易类型 |
1-消费，2-撤销，3-退款，4-充值 |
||
|
transTime |
String |
是 |
|
交易时间 |
格式：yyyy-MM-dd HH:mm:ss |
||
|
shopId |
Integer |
是 |
|
店铺ID |
|
||
|
shopCode |
String |
否 |
|
店铺编号 |
|
||
|
shopName |
String |
是 |
|
店铺名称 |
|
||
|
customerId |
Integer |
否 |
|
顾客ID |
|
||
|
trxId |
String |
否 |
|
收银宝支付流水号 |
|
||
|
openId |
String |
否 |
|
机构公众号openId |
|
||
|
remark |
String |
否 |
|
备注 |
|
||
|
orderItemList
|
ArrayList |
|
|
否 |
|
|
|
|
itemType |
|
Integer |
否 |
|
订单明细类别 |
1、实体商品；2、虚拟商品；3、充值 |
|
|
skuId |
|
Integer |
否 |
|
货品ID |
|
|
|
salePrice |
|
Integer |
否 |
|
销售价 |
单位分 |
|
|
nums |
|
Integer |
否 |
|
购买数量 |
|
|
|
amount |
|
Integer |
否 |
|
总金额 |
单位分 |
|
|
score |
|
Integer |
否 |
|
积分价 |
积分数 |
|
|
shareId |
|
Integer |
否 |
|
分享ID |
|
|
|
guideId |
|
Integer |
否 |
|
导购ID |
|
|
|
refereeCustomerId |
|
Integer |
否 |
|
推荐会员ID |
|
|
|
skuInfoList |
ArrayList |
|
否 |
|
|
|
|
|
|
templateId |
Integer |
否 |
|
券模板ID |
|
|
|
|
templateName |
String |
否 |
|
券模板名称 |
|
|
|
|
num |
Integer |
否 |
|
张数 |
|
|
5.4券核销撤销通知
卡券（实体卡、满减券、金额券、计次券）撤销核销时的数据通知
业务请求参数
method: allinpay.shopoint.couponService.cancelNotify
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
|
changeId |
Integer |
是 |
核销记录编号 |
|
|
|
couponId |
Integer |
是 |
券编号 |
|
|
|
couponNo |
String |
是 |
|
券号 |
|
|
templateId |
Integer |
是 |
券模板编号 |
|
|
|
refundAmount |
String |
是 |
撤销金额 |
单位为分 |
|
|
tranDateTime |
String |
是 |
|
撤销交易时间 |
格式: yyyyMMddHHmmss |
|
unit |
String |
否 |
|
单位, 计次券使用 |
|
|
couponName |
String |
是 |
|
券名称 |
|
|
shopId |
Integer |
否 |
|
核券店铺ID |
|
|
shopCode |
String |
否 |
|
店铺号 |
|
|
shopName |
String |
否 |
|
核销店铺名称 |
|
|
orderId |
Integer |
否 |
核销时内部订单号 |
|
|
|
cardNo |
String |
否 |
|
会员卡号 |
|
|
publicOpenId |
String |
否 |
|
机构公众号OPENID |
|
|
mobile |
String |
否 |
|
手机号 |
|
|
orgId |
Integer |
否 |
|
机构ID |
|
|
orgName |
String |
否 |
|
机构名称 |
|
|
customerId |
Integer |
否 |
|
数字营销会员ID |
|
|
createUserId |
Integer |
否 |
|
核销人登录账号 |
|
|
createUserSysno |
Integer |
否 |
|
核销人ID |
|
|
createUserName |
String |
否 |
|
核销人姓名 |
|
|
outOrderId |
String |
否 |
|
核销外部订单号 |
|
5.5跨机构订单支付通知
业务请求参数
method: allinpay.shopoint.orderService.partnerNotify
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
|
orderCode |
String |
是 |
|
订单号 |
|
|
finishTime |
String |
是 |
|
订单完成时间 |
格式：yyyy-MM-dd HH:mm:ss |
|
customerMobile |
String |
是 |
|
用户手机号 |
|
|
openId |
String |
否 |
|
微信openid |
|
|
mchtCd |
String |
否 |
|
商户号 |
|
|
mchtName |
String |
是 |
|
商户名称 |
|
|
qrCodeBoardNo |
String |
否 |
|
码牌编号 |
|
|
amount |
Integer |
是 |
|
订单原始金额 |
单位分 |
|
useScore |
Integer |
是 |
|
使用积分数 |
|
|
paymentAmount |
Integer |
是 |
实际支付金额 |
单位分 |
|
|
paymentMethod |
Integer |
是 |
支付方式 |
0-微信，1-支付宝，2-手机QQ，3-银联，99-其他 |
|
|
tradeType |
Integer |
是 |
交易类型 |
1-消费，2-退款 |
5.6微信核销通知转发
业务请求参数
method: allinpay.shopoint.couponService.wechatCheckNotify
参考https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter9_1_15.shtml中的核销券通知参数
5.7发券通知
业务请求参数
method: allinpay.shopoint.couponService.sendNotify
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
|
|
customerId |
Integer |
否 |
|
领券人ID |
|
|
|
promotionId |
Integer |
否 |
|
活动ID |
|
|
|
promotionName |
String |
否 |
|
活动名称 |
|
|
|
guideUserId |
Integer |
否 |
|
导购编号 |
|
|
|
openId |
String |
否 |
|
领券人OpenId |
|
|
|
mobile |
String |
否 |
|
领券人手机号 |
|
|
|
externalCode |
String |
否 |
|
领券人外部编号 |
|
|
|
num |
Integer |
否 |
|
发券数量 |
|
|
|
type |
Integer |
否 |
|
发券类型 |
1券发放 2券变更 3券核销 |
|
|
scene |
Integer |
否 |
|
发券场景 |
19顾客领通联券 27 顾客领系统用户发的通联券 20 顾客购买通联券 28 顾客积分购买通联券 24顾客领订单返的通联券 29 顾客领微信券 33 顾客使用积分购买微信券 1系统用户激活通联券 3系统用户激活微信券 8 系统用户冻结通联券 35系统用户核销通联券 |
|
|
couponList
|
ArrayList |
|
否 |
|
|
|
|
couponNo |
String |
否 |
|
通联券券号 |
|
|
|
outOrderId |
String |
否 |
|
外部订单号 |
|
|
|
couponType |
Integer |
否 |
|
券类型 |
0金额券1代金券2计次券3满减券 |
|
|
initAmount |
Integer |
否 |
|
初始金额、次数 |
单位：分/次 |
|
|
templateId |
Integer |
否 |
|
通联券券模板ID |
|
|
|
wechatCouponId |
String |
否 |
|
微信券券号 |
微信开放平台发券券号 |
|
|
wechatStockId |
String |
否 |
|
微信发券批次号 |
|
|
|
createTime |
String |
否 |
|
发券时间 |
格式：yyyy-MM-dd HH:mm:ss |
|