4.1 公共返回码（code）
数字营销对开发者的接口非业务调用错误做统一处理，返回码如下：
|
code（返回码） |
messasge（返回码描述） |
解决方案 |
|
0 |
请求成功 |
|
|
302 |
接口限流控制 |
减少接口并发调用频次或联系管理员申请更大并发 |
|
500 |
接口未知异常 |
对于有幂等要求的接口需调用对应的查询接口来获取最终调用状态，如：发券、充值等；对于无幂等要求的接口重试调用即可 |
|
1001 |
缺少字段 |
调整接口格式 |
|
2001 |
数量或金额错误 |
金额数量大于0 |
|
3101 |
无法识别的ID或账号 |
检查ID或账号 |
|
3102 |
机构错误 |
检查发起机构是否正确 |
|
3103 |
无操作权限 |
检查操作员是否具有权限 |
|
3104 |
动态码超时 |
重新获取动态码 |
|
3106 |
密码错误 |
检查密码 |
|
3201 |
业务处理失败 |
调用微服务失败 |
|
3999 |
其他错误 |
具体错误信息查看msg |
7.1终端信息字段说明
terminfo字段
|
参数 |
参数名称 |
可空 |
最大长度 |
取值 |
备注 |
|
termno |
终端号 |
否 |
8 |
8位数字 |
商户下唯一 |
|
devicetype |
设备类型 |
否 |
2 |
01：自动柜员机（含 ATM 和 CDM）和多媒体自助终端 02：传统 POS 03：mPOS 04：智能 POS 05：II 型固定电话 06：云闪付终端； 07：保留使用； 08：手机 POS； 09：刷脸付终端； 10：条码支付受理终端； 11：条码支付辅助受理终端； 12：行业终端（公交、地铁用于指定行业的终端）； 13：MIS 终端； |
|
|
termsn |
终端序列号 |
是 |
50 |
|
终端类型（device_type）填写为 02、03、04、05、06、08、09 或 10时，必须填写终端序列号。 |
|
encryptrandnum |
加密随机因子 |
是 |
10 |
仅在被扫支付类交易报文中出现：若付款码为 19 位数字，则取后6 位；若付款码为 EMV 二维码，则取其tag 57 的卡号/token 号的后 6 位 |
|
|
secrettext |
密文数据 |
是 |
16 |
仅在被扫支付类交易报文中出现：64bit 的密文数据，对终端硬件序列号和加密随机因子加密后的结果。本子域取值为：64bit 密文数据进行base64 编码后的结果。 |
|
|
appversion |
终端程序版本号 |
是 |
8 |
|
终端应用程序的版本号。应用程序变更应保证版本号不重复。当长度不足时，右补空格。 |
|
longitude |
经度 |
是 |
16 |
经度信息格式：1位正负号+3位整数 +1位小数点 +5位小数， +表示东经， -表示西经，例如 +121.483527 |
受理终端设备实时经度信息 |
|
latitude |
纬度 |
是 |
16 |
纬度信息格式：1位正负号+2位整数+1位小数点 +6 位小数，+表示北纬， -表示南纬，例如+31.221345或-03.561345 |
受理终端设备实时纬度信息 |
|
deviceip |
终端IP |
是 |
40 |
|
商户端终端设备 IP 地址。注：如经、维度信息未上送，该字段必送。 |
示例
terminfo={"termsn":"dfjskljioe13238023","longitude":"+37.12","latitude":"-37.12","termno":"00000001","devicetype":"04"}
7.2 splitList字段说明
该字段提供对接方上送指定分账信息。如果上送此字段，必须开通数字营销资金管理功能。
- 最多支持3层分账。延时分账业务只支持一层。
- splitIdType为0-机构的主体类型时，不需要传splitCode和splitId，其他类型必须传splitCode或splitId，都传以splitId为准。
- splitIdType为0-机构或3-分佣方时，上送金额为最终分账金额，不再匹配系统配置的分账规则进行分账。
- 每层未全部分完时，剩余部分默认分账到对应的上层分账主体中，且不再匹配系统配置的分账规则进行分账。(建议：对未分完的部分，为了简化商户对接部分退款的处理，商户进行计算与管理，一并上送到分账信息中，splitIdType传3。否则商户在进行部分退款退分账未分完部分时，业务处理会比较复杂)。
- 延时分账splitIdType支持0、3。
- 退款
- 整单退时，不需要上送splitList字段，如果上送splitList字段，则按部分退款规则处理
- 部分退款，若需要各个分账完均摊退款金额，则不需要上送splitList，系统会自动计算各个分账主体退的金额;
- 部分退款，非均摊退款时，需要上送各分账方完整的退款分账规则。若上送的分账方对应的订单分账存在下级分账时，需要上送指定下级退款的分账规则，包含默认的分账。
- 部分退款，指定退分账未分完的部分时，splitIdType传3。
- 延时分账退款时，若已存在部分分账确认的子单号，则未分账确认部分不可退款，如果要对未分账确认部分进行退款，则需先调用分账确认接口分账到收款店铺后再进行退款。若整笔订单未进行分账确认，则可发起退款。
|
参数 |
参数名称 |
取值 |
|
splitIdType |
分账主体类型 |
0-机构、1-店铺，2-大类，3-分佣方，4-商品 |
|
splitCode |
分账主体CODE |
数字营销的店铺、大类、商品、分佣方等的code，分账主体类型为0时可不传 |
|
splitId |
分账主体ID |
数字营销的店铺、大类、商品、分佣方等的ID，分账主体类型为0时可不传 |
|
amount |
分账金额 |
金额，单位分 |
|
remark |
备注 |
|
|
subReqSn |
分账子订单号 |
延时分账业务，需要上送 |
|
splitList |
下层分账 |
asinfo |
示例：订单收款0.3元（30分）
[
{
"splitIdType": 1,
"splitCode": "10668",
"amount": 10,
"remark": "分给店铺10668"
},
{
"splitIdType": 3,
"splitId": "10666",
"amount": 10,
"remark": "分给分佣方10666"
},
{
"splitIdType": 0,
"amount": 10,
"remark": "分给平台机构"
}
]
说明：分给平台和10666的为最终分账结果，即到账金额；分给10668的0.1元，若系统配置有分账规则，则还要根据配置的分账规则继续进行分账处理。
7.3 店铺经营类型枚举
|
id |
value |
|
101001 |
家居 |
|
101002 |
配套 |
|
101003 |
茶业 |
|
101004 |
化妆品 |
|
101005 |
数码 |
|
101006 |
集合店 |
|
101007 |
美甲 |
|
101008 |
饮品 |
|
101009 |
眼镜 |
|
101010 |
女装 |
|
101011 |
箱包 |
|
101012 |
教育 |
|
101013 |
餐饮 |
|
101014 |
娱乐 |
|
101015 |
摄影 |
|
101016 |
服饰 |
|
101017 |
零售 |
|
101018 |
鞋帽 |
|
101019 |
医美 |
|
101020 |
加油站 |
|
101021 |
超市 |
|
101022 |
学校 |
|
101023 |
政府类 |
|
101024 |
中介 |
|
101025 |
旅游 |
|
101026 |
房地产 |
|
101027 |
酒店 |
|
101028 |
工艺美术品 |
|
101030 |
珠宝金饰 |
|
1901645 |
银行 |
|
1901678 |
汽车 |