统一支付接口设计

1、接口说明

支付接口用于后台根据自己逻辑的单号生成签名用于调起第三方。

2、接口地址

xxx/v1/pay

3、接口格式

上行：Key & Value

下行：JSON

4、协议

HTTP/POST

5、输入参数

参数名

类型

是否必填

备注

token

String

是

appId

string

否

设备唯一标识

appVersion

string

否

APP版本

imei

string

否

手机串码

phoneModel

string

否

手机型号

timestamp

string

是

时间戳

orderId

 string

是

对应业务的单号

orderType

int

是

业务类型（1、 普通行程订单 2、企业行程订单  3.xxx

   4.小程序行程订单   40:钱包充值订单）

payment

int

是

支付方式(0免单支付，1支付宝(项目app)，2微信(项目app) 3(企业支付) 4.余额支付 5银联支付...   ）201:公众号/小程序 

openId

String特殊是当payment= 201  公众号/小程序支付时 必须传入 OpenID    当payment=421 同理

appCode

String特殊是当payment=201 公众号/小程序支付时     项目xx端小程序 :"12021"   当payment=421 同理

PS.已规划appCode    10010(零元) 11010(支付宝APP) 12020(微信APP)12021(xx小程序)12022(XX公众号微信原生扫码) 12023(XX公众号微信H5) 13010(企业) 14010(余额支付)   14011(余额支付-余额自动支付)  

6、请求示例

orderId=133&orderType=1&payment=1

7、输出参数

参数名

类型

是否必填

备注

code

Integer

是

状态码

msg

String

否

返回消息

data

Object

否

返回数据

Object内容（支付宝）

 说明：因为此接口返回的是第三方要求的需要可以被调起的签名格式，故Object内容为一个经过加密的字符串。移动端拿到数据调用即可

Object内容（微信） 

参数名

类型

是否必填

备注

app_id

String

是

微信开放平台审核通过的应用APPID

partnerid 

String

是

微信支付分配的商户号

prepayid

String

是

微信返回的支付交易会话ID

package 

String

是

暂填写固定值Sign=WXPay

noncestr 

String

是

随机字符串，不长于32位。

timestamp 

String

是

时间戳

sign 

String

是

签名

 

支付宝

{

      "data": “

alipay_sdk=alipay-sdk-java-3.1.0 &app_id=xxx &biz_content={"xxx_amount":"0.01"} &charset=UTF-8 &format=json &method=alipay.trade.app.pay ¬ify_url=xxxpayAliCallback &return_url=xxxFreturn &sign=cyu9MIAJGjGZ7yQKo7Lvu4C8cVCm+OeME+9A++YkabZiBMguCPhtzQliruUaE5yyWhbNBtIqwT+b4vIWzhb/lEiFcovcsKYbe46lDo9ihy/b/TMBX%x'x'x+khIcykHpfjfZLrWjdD7flsPRIotoBq%xxx/6vBQPC/v8feQBlmFEfgoLLX8IBnFd5G/6n0GIwfVjOArSQ58izGuNjjXHHdtTbbiOD2oJMfAomUlCCwIOBYEvexgO4qOWKOFqcGOwnu594a4tG7vnCtOuTTwA== &sign_type=RSA2 ×tamp=2018-07-11+11:34:00 &version=1.0"

”

}

微信

{

 "code":0,

  "data": {

       "package":"Sign=WXPay",

       "appid":"xxx",

       "partnerid":"xxx",

       "prepayid":"wx20180711174645947779",

       "noncestr":"gSBpmOpKk8mhvdGTZaie",

       "timestamp":"1531302402"

       "sign":"EE8707786C6D008E48608291E971A920",

      }

}

小程序支付结果:

{

 "code":0,

  "data": {

        "appId":"xxxx",

        "timeStamp":"Sign=WXPay",

        "nonceStr":"wx1930ad04c1e714a8",

        "package":"prepay_id=xxxxxx",

        "signType":"MD5",

        "paySign":"EE8707786C6D008E48608291E971A920",

      }

}

企业支付

{

      "code":0,

      "msg": "支付成功!"

}

9、状态码

态码 msg 200支付成功订单已支付xxx2订单已关闭xxx3校验订单信息失败(未到支付状态/未查询到订单)xxx4支付渠道错误xxx5MQ广播通知错误xxx6操作失败

转载于:https://www.cnblogs.com/wangdaijun/p/10956991.html

相关资源：网页转微信支付宝接口设计