开放平台
接入提示
平台（优米自动化发卡平台）可使用接口方式实现24小时无人值守实时卡密自动化交易，商户需自行开发接入。
使用平台服务前请确保商户已提交入网资料且处于成功入网状态方可接入。
仅限正规行业商户入网，切勿将本平台服务用于非法行业，商户的所有交易将受到平台、入网渠道（支付宝、微信）、用户共同监管。
监管过程如识别到商户将本平台服务用于非法行业，平台及入网渠道将对商户做出惩戒措施，包括但不限于强制退款、批量退款、风险同步、平台清退、渠道清退等措施。
订单信息报备
请求方式：GET / POST
请求网址：https://pay.umistrong.com.cn/api/risk
结果返回：success
其他说明：本接口为【创建订单】前置流程，报备成功会返回success
参数说明：
参数名称 变量名 类型长度 是否必须 说明 示例值
版本号 version varchar(5) 是 默认 1.0 1.0
商户编号 customerid int(6) 是 商户后台获取
商户订单号 sdorderno varchar(50) 是 本接口报备成功后，请使用相同订单号【创建订单】
md5签名 sign varchar(32) 是 参照md5签名方法
用户端IP mcCreateTradeIp varchar(128) 是-重要 用户外网IP 111.111.111.111
用户注册时间 extraAccountRegTime varchar(128) 否 用户账户注册时间，格式yyyy-MM-dd HH:mm:ss 2022-01-01 08:00:00
用户姓名 extraAccountName varchar(128) 否 李**
用户证件号 extraAccountCertno varchar(128) 否 用户证件号（可脱敏，通过单向限函数 Hash 脱敏） 320112111100001111
用户证件号后6位明文 extraAccountCertnoLastSix varchar(128) 是-重要 001111
用户手机号 extraAccountPhone varchar(128) 否 用户手机号（可脱敏，通过单向限函数 Hash 脱敏） 13900001111
用户手机号后2位明文 extraAccountPhoneLastTwo varchar(128) 是-重要 11
用户被充值卡号 chargedCardNumber varchar(128) 是-重要 商户端的用户UID、记名与不记名礼品卡储值卡卡号 VIP000001
用户ID desensitizedUid varchar(128) 是-重要 商户端的用户UID C000001
用户风险等级 extraAccountRiskLevel varchar(128) 是-重要 商户为用户账户评级，注册时间、账户活跃度、充值笔数、历史投诉等方面评估；高,中,低风险等级对应的枚举值为high,mid,low low
用户端LBS mcCreateTradeLbs varchar(128) 否-重要 用户端经纬度 118.269200,31.368000
用户端网络类型 netWork varchar(128) 否 4g、5g、wifi wifi
用户端wifiMAC地址 wifiMac varchar(128) 否 用户端无线MAC地址 1c:aa:07:b0:e7:af
用户端设备IMEI mcCreateImei varchar(128) 否 用户端的设备序列号IMEI 1rfe-123e-124rf-123e
用户端网络MAC mcCreateMac varchar(128) 否 用户端网卡MAC地址 06:cc:00:a1:a2:cb
用户端手机操作系统 mobileOperatingPlatform varchar(128) 否 android、ios、windows ios
用户端操作系统版本 sysVersion varchar(128) 是-重要 用户端操作系统版本，例如iOS 15.4.2传15.4.2 15.4.2
用户端型号 platformType varchar(128) 是-重要 用户端设备型号，例如红米9A传M2006C3LC M2006C3LC
交易商品渠道 mcCreateTradeChannel varchar(128) 否-重要 例如电脑网站、手机网站、APP、小程序 小程序
交易风险等级 extraCreateTradeRiskLevel varchar(128) 否 商户为用户交易评级，历史支付金额、支付频率、支付投诉、支付时间段等方面评估；高中低风险等级对应的枚举值为high,mid,low low
商户端订单生成时间 mcCreateTradeTime varchar(128) 是-重要 格式yyyy-MM-dd HH:mm:ss 2022-01-01 08:00:00
商户应用包名 mcCreateTradePackage varchar(128) 是-重要 商户发布应用的包名 com.alipay.alipay
是否sdk支付 isPayBySDK varchar(128) 否 交易是否是通过商户app内sdk支付，是或否对应的枚举值为Y或N N
md5签名方法：
1、非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA
2、在stringA最后拼接上&apikey={apikey};
3、使用md5签名上面拼接的字符串即可生成小写的32位密文
创建订单
请求方式：GET / POST
请求网址：https://pay.umistrong.com.cn/api/submit
参数说明：
参数名称 变量名 类型长度 是否必须 说明
版本号 version varchar(5) 是 默认 1.0
商户编号 customerid int(6) 是 商户后台获取
商户订单号 sdorderno varchar(50) 是
订单标题 subject varchar(256) 是 所有订单的商品名称需要明确填写 (如:游戏饰品/网络服务/充值等关联实际业务场景的名称)
举例：电商或者游戏类
xx电商平台-xx元订单号
xx游戏平台-xx元订单号
游戏名-xx元订单号
订单描述 body varchar(128) 否
订单金额 totalfee decimal(10,2) 是 最多两位小数
支付编号 paytype varchar(12) 是
支付编号 支付渠道 适用场景 系统行为
alipay 支付宝PC 电脑网站支付 跳转支付宝PC付款页
alipaywap 支付宝WAP 手机网站支付 手机浏览器跳转支付宝WAP付款页
alipayapp 支付宝APP 手机APP支付 跳转支付宝APP支付请求参数字符串
weixinh5 微信H5 手机网站支付 手机浏览器跳转唤起手机微信收银台
weixinjsapi 微信公众号 手机微信内置浏览器支付 手机微信扫一扫弹出收银台
异步通知URL notifyurl varchar(50) 是 不能带有任何参数
同步跳转URL returnurl varchar(50) 是 不能带有任何参数
md5签名 sign varchar(32) 是 参照md5签名方法
md5签名方法：
version={value}&customerid={value}&totalfee={value}&sdorderno={value}&notifyurl={value}&returnurl={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
异步通知回调
通知方式：POST
立即核销回复：success
延迟核销回复：wait
参数说明：
参数名称 变量名 类型长度 说明
商户编号 customerid int(6)
商户订单号 sdorderno varchar(50)
平台订单号 sdpayno varchar(50)
订单金额 totalfee decimal(10,2) 通知回调业务处理过程中务必验证订单金额，支付失败返回金额为0
支付类型 paytype varchar(12) 同创建订单支付编号
md5验证签名 sign varchar(32) 参照md5签名方法
激活卡卡密 card varchar(50) 仅在订单支付成功时生成卡密
付款人ID buyer_id varchar(50) 支付宝端付款人ID
付款人账户名 buyer_logon_id varchar(50) 支付宝端付款人账户名
md5签名方法：
customerid={value}&totalfee={value}&sdorderno={value}&sdpayno={value}&paytype={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
订单查询
请求方式：GET / POST
请求网址：https://pay.umistrong.com.cn/api/query
参数说明：
参数名称 变量名 类型长度 是否必须 说明
版本号 version varchar(5) 是 默认 1.0
商户编号 customerid int(6) 是 商户后台获取
商户订单号 sdorderno varchar(50) 是
md5签名 sign varchar(32) 是 参照md5签名方法
md5签名方法：
version={value}&customerid={value}&sdorderno={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
结果返回：
参数名称 变量名 类型长度 说明
支付状态 status int(2) 0 -> 已付款，商户系统已核销
1 -> 未付款
2 -> 已付款，商户系统待核销
3 -> 已退款，全额退款
5 -> 已退款，部分退款
6 -> 自动退款（针对部分恶意用户付款后投诉平台采取的拦截措施）
商户订单号 sdorderno varchar(50)
平台订单号 sdpayno varchar(50)
渠道订单号 tradeno varchar(50) 未付款订单不返回
交易金额 totalfee decimal(10,2) 最多两位小数
支付类型 paytype varchar(12) 同创建订单支付编号
订单时间 datetime varchar(14) yyyyMMddHHmmss
付款时间 paytime varchar(14) yyyyMMddHHmmss，未付款订单不返回
退款明细 refund JSONArray 已退款订单返回此参数
参数名称 变量名 类型长度 说明
商户退款单号 sdrefundno varchar(50)
退款类型 refundtype int(2) 0 -> 全额退款
1 -> 部分退款
退款金额 refundfee decimal(10,2)
退款时间 datetime varchar(14) yyyyMMddHHmmss
退款状态 status int(2) 0 -> 退款成功
1 -> 退款失败
订单核销
请求方式：GET / POST
请求网址：https://pay.umistrong.com.cn/api/consume
结果返回：success
参数说明：
参数名称 变量名 类型长度 是否必须 说明
版本号 version varchar(5) 是 默认 1.0
商户编号 customerid int(6) 是 商户后台获取
商户订单号 sdorderno varchar(50) 是
md5签名 sign varchar(32) 是 参照md5签名方法
md5签名方法：
version={value}&customerid={value}&sdorderno={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
订单退款
请求方式：GET / POST
请求网址：https://pay.umistrong.com.cn/api/refund
结果返回：success
其他说明：订单成功退款会返回success
其他说明：调用本接口后，需退款金额将原路退回支付方，但商户在本平台已产生的平台手续费不退还，请确保商户账户余额大于需退款金额
参数说明：
参数名称 变量名 类型长度 是否必须 说明
商户退款单号 sdrefundno varchar(50) 是 退款业务单号，一般为商户订单号前加R，可全额退款，也可多次部分退款
例：
商户订单号001
全额退款：商户退款单号R001
部分退款：商户退款单号R001-1，R001-2，R001-3（以此类推，不能重复）
退款金额 refundfee decimal(10,2) 是 最多两位小数且金额不能大于商户订单可退金额
可退金额 = 实付金额 - 已退款金额
版本号 version varchar(5) 是 默认 1.0
商户编号 customerid int(6) 是 商户后台获取
商户订单号 sdorderno varchar(50) 是
md5签名 sign varchar(32) 是 参照md5签名方法
md5签名方法：
version={value}&customerid={value}&sdorderno={value}&sdrefundno={value}&refundfee={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
接入注意事项
1.付款结果以异步通知为准
2.不论异步通知还是同步通知必须再次验证totalfee金额是否与创建订单时的金额一致，支付失败返回金额为0
3.系统有可能进行多次异步回调，要做好商户系统接收通知接口的订单处理逻辑，避免订单重复核销
4.订单支付成功后会立即对商户系统进行异步回调通知商户核销卡密，商户系统需在订单核销完成后输出"success"反馈订单核销结果
5.商户如无需立即对卡密进行核销，异步通知输出"wait"，等待后续用户核销时调用《卡密核销》接口对交易订单进行状态同步