统一下单

请求方式 body 编码 接口地址
POST application/json UTF-8 /api/v1/payment/unifiedorder

请求参数

字段名 变量名 必填 类型 示例值 描述
unionId 连尚unionId N String(32) dafwfawfawfafwa
openId 连尚数字ID N String(32) 2398724h98y912
appId 商户应用ID Y String(32) djgeiq978y933
appName 商户应用名称 Y String(32) 2324424214124124
mchId 商户号 Y String(20) 93745641 商户号
outTradeNo 商户订单号 Y String(32) hiuhei09023j12j40206 商户订单号
timeStart 交易起始时间 N String(14) 20180801160000 格式：yyyyMMddHHmmss
timeExpire 交易结束时间 N String(14) 20180801180000 格式：yyyyMMddHHmmss
totalFee 总金额 Y Int 100 单位：分
notifyUrl 商户通知回调地址 Y String(300) https://notify.shengpay.com/notify 接收连尚支付异步通知回调地址，通知url必须为直接可访问的url，不能携带参数。
nonceStr 随机字符串 Y String(32) pWUVWVYWNQhnTXpQzhIzMGCwqBkZclzg 随机字符串仅做加签混淆用
goodsTag 优惠tag N String(32) WIFI_DISCOUNT_001 虚拟币、代金券或优惠减免功能参数，由连尚支付和商户共同发起
body 商品描述 Y String(128) 抓娃娃机-游戏充值
detail 交易信息 N String(3000) 单个商品： {\"goodsDetails\":[{\"goodsId\":\"goodsId1\",\"goodsName\":\"goodsIName1\",\"price\":100,\"quantity\":1}]} 多个商品： "{\"goodsDetails\":[{\"goodsId\":\"goodsId1\",\"goodsName\":\"goodsIName1\",\"price\":100,\"quantity\":1},{\"goodsId\":\"goodsId2\",\"goodsName\":\"goodsIName2\",\"price\":200,\"quantity\":1}]}"
attach 商户附属信息 N String(128) {\"memo\":\"test\"}
applyMchId 发起方商户号 N String(20)
applyType 申请方式 N String(20) PROXY
tradeType 交易方式 Y String(20) APP APP,JSAPI
signType 签名类型 Y String(10) RSA 目前只支持RSA
sign 签名 Y String(500) 加签方式参考：请求加签说明 
{
    "openId":"2398724h98y912",
    "appId":"djgeiq978y933",
    "appName":"2324424214124124",
    "mchId":"93745648",
    "outTradeNo":"hiuhei09023j12j40206",
    "timeStart":"20180801160000",
    "timeExpire":"20180801180000",
    "totalFee":100,
    "notifyUrl":"https://notify.shengpay.com/notify",
    "nonceStr":"pWUVWVYWNQhnTXpQzhIzMGCwqBkZclzg",    
    "goodsTag":"WIFI_DISCOUNT_001",
    "body":"抓娃娃机-游戏充值",
    "detail":"{\"goodsDetails\":[{\"goodsId\":\"goodsId1\",\"goodsName\":\"goodsIName1\",\"price\":100,\"quantity\":1}]}",
    "attach":"{\"memo\":\"test\"}",
    "tradeType":"APP",
    "signType":"RSA",
    "sign":"ZdNjNnZL2EMsDvX9C/2ap8uKk18x8ungs42u9y96PrWCQ7flMDePcLL61eG0bgBJdJzd88N54NLzprPa5CSIrI0+FZTWPDDmVMoXz74dyxqFzub9aag0uoyJvD8LDI4bIF6skHuJr6j4tQUPugJ5MtNPJOWG7aHjY4I9HXdN9iw="
}

detail字段

字段名 变量名 必填 类型 示例值 描述
goodsDetails 商品详细信息 Y String(2500)

goodsDetail字段

字段名 变量名 必填 类型 示例值 描述
goodsId 商品编码 N String(32)
goodsName 商品名称 Y String(32)
quantity 商品数量 Y Int
price 商品单价 Y Int 单位：分 
{
    "goodsDetails":[
        {
            "goodsId":"goodsId1",
            "goodsName":"goodsIName1",
            "quantity":"1",
            "price":"100"
        }
    ]
}

响应参数

字段名 变量名 必填 类型 示例值 描述
returnCode 返回码 Y String(32) SUCCESS SUCCESS/FAIL 此字段为业务交互通信标志
returnMsg 返回消息 Y String(32) OK 当returnCode为FAIL时，返回错误信息
resultCode 业务结果 Y String(32) SUCCESS SUCCESS/FAIL
errorCode 错误代码 N String(32) 当resultCode为FAIL时，errorCode必填
errorCodeDes 错误描述 N String(64) 当resultCode为FAIL时，errorCodeDes必填
appId appId N String(32) 当resultCode为SUCCESS时，appId必填
mchId 商户号 N String(32) 当resultCode为SUCCESS时，mchId必填
prepayId 预支付Id N String(64) WP2018080116535234056089817260601344 当returnCode和resultCode为SUCCESS时，prepayId必填
tradeType 交易方式 N String(22) APP 当returnCode和resultCode为SUCCESS时，tradeType必填
nonceStr 随机字符串 Y String(32) CKDjdKqSkPUfWmuOFCXOmTkWtgVklZNF
signType 加签方式 Y String(10) RSA 目前只支持RSA
sign 签名 Y String(500) 
{
  "appId": "djgeiq978y933",
  "mchId": "93745648",
  "nonceStr": "CKDjdKqSkPUfWmuOFCXOmTkWtgVklZNF",
  "prepayId": "WP2018080116535234056089817260601344",
  "resultCode": "SUCCESS",
  "returnCode": "SUCCESS",
  "returnMsg": "OK",
  "sign": "IW93NZkqfLxTgA2eHoKdq/qd4BhCAMniSZU5riF1yb7UxQEj5sdolwHW4h8nSM279hXfCDSA8Oca/26XsChRG1WzbFgkjDkd3glBr5E3cGKmCOSpi0v1UkFeIAW8V2kTD1keUOXWgvlLkjVV/T2pfyKYr9xebEUwbU6r+rCnqos=",
  "signType": "RSA",
  "tradeType": "APP"
}

错误码描述

返回码 返回文案 解决方案
NO_AUTH 商户无此接口权限 请商户前往申请此接口权限
ORDER_PAID 商户订单已支付 商户订单已支付，无需更多操作
ORDER_PAYING 订单支付处理中 订单支付处理中，无需重复操作
ORDER_CLOSED 订单已关闭 当前订单已关闭，请重新下单
REFUND_COMPLETED 退款已完成 退款已完成
SYSTEM_ERROR 系统错误 系统异常，请用相同请求参数重新发起请求
APP_ID_NOT_EXIST appId不存在 请检查appId是否正确
MCH_ID_NOT_EXIST mchId不存在 请检查mchId是否正确
APP_ID_AND_MCH_ID_NOT_MATCH appId和mchId不匹配 请确认appId和mchId是否匹配
LACK_PARAMS 缺少参数 请检查参数是否齐全
PARAMS_ERROR 参数问题 请检查参数值是否符合
OUT_TRADE_NO_USED 商户订单号重复 请核实商户订单号是否重复提交
SIGN_ERROR 签名错误 请检查签名参数和方法是否都符合签名算法要求
TIME_FORMAT_ERROR 支付时间格式错误 请确认支付时间格式是否为yyyyMMddHHmmss
TIME_ERROR 支付时间错误 请调确认支付时间