3.6订单生成


接口地址: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

详见安全规范


卜子超buzc 2025年5月14日 16:00 收藏文档