接口地址:https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/tranx/createorder
测试地址:https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/tranx/createorder
使用场景:终端POS交易支付,使用本接口请求返回的orderNo订单号,完成支付。如果上送分账信息,调用此接口前需要开通数字营销结算资金管理功能。
该接口不支持阶梯分账(可正常收款,但不执行阶梯分账规则)。
请求参数
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
reqsn |
商户交易单号 |
商户的交易订单号 |
否 |
64 |
保证商户平台唯一 |
trxamt |
交易金额 |
单位为分 |
否 |
15 |
|
membertype |
会员账户类型 |
|
是 |
2 |
1-手机号 2-会员卡号 3-Openid 4-会员动态码 5-外部会员ID 6-内部会员ID |
memberid |
会员账号 |
|
是 |
180 |
|
remark |
备注 |
备注信息 |
是 |
160 |
禁止出现+,空格,/,?,%,#,&,=这几类特殊符号 |
asinfo |
分账信息 |
上送分账信息,json字符串 |
是 |
1024 |
参照附录4.7asinfo字段说明 |
signtype |
签名类型 |
|
是 |
8 |
支持MD5、RSA、SM2,不填默认MD5 |
sign |
签名 |
|
否 |
32 |
详见安全规范 |
splitflag |
分账标识 |
|
否 |
2 |
1-自动分账,默认1 2-不分账 3-延时分账/收款 若上送2时,忽略接口上送的asinfo;若上送3,则必须调用“3.21分账/收款确认”接口完成分账或收款入账。 |
响应参数
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
此字段是通信标识,非交易结果,交易是否成功需要调用查询接口返回状态来判断 |
retmsg |
返回码说明 |
|
是 |
100 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
orgid |
机构ID |
实际交易的机构ID |
否 |
11 |
|
reqsn |
商户交易单号 |
商户的交易订单号 |
否 |
64 |
|
orderno |
订单号 |
|
否 |
64 |
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
initamt |
原交易金额 |
|
是 |
15 |
与请求字段trxamt值一致,单位:分 |
trxamt |
实际交易金额 |
|
是 |
15 |
用于区分优惠活动的金额,单位:分 |
signtype |
签名类型 |
|
否 |
4 |
支持MD5、RSA、SM2 |
sign |
签名 |
|
否 |
32 |
详见安全规范 |