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

10-微信小程序Openid

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分账/收款确认”接口完成分账或收款入账。

receivershopid

收款人店铺ID

 

是

11

只有开通资金管理功能的机构生效

notify_url

交易结果通知地址

接收交易结果的通知回调地址,通知url必须为直接可访问的url,不能携带参数。
https只支持默认端口

是

256

若使用https,需使用默认443端口

 

响应参数

字段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

详见安全规范


2025年12月12日 16:05 收藏文档