支付系统（java） - 美好集团文档管理系统

最后修改人	李武才
最后修改时间	2025-03-20 14:03:59
创建人	李武才
创建时间	2025-03-20 10:27:38

该文档由李武才创建于 2025-03-20 10:27:38 ，李武才在 2025-03-20 14:03:59 修改了该文档。

释：前提准备：

一： "mchId": "AcmNlJcLiQDkiHIUnKTM0fqjwGn8jbUrXfSeiWnGR1_1X6ppwLiPZm_CNsq6dzR-q0At0Q7VD9BRZMm2" 商户帐号。`paypal支付没有商户帐号的概念，以payapl创建的app下的client_id作为商户帐号。`

二： "returnUrl": "https://pay.meihao.com/prod-api/mh-extend-pay/api/v1/paypal/successPayRedirect"

`paypal 支付链第一步支付成功重定向的url。 是支付成功后paypal同步重定向跳转页面不能为空(成功付款后,在在重定向接口确认定单，才真正创建成功并付款成功，在后台管理页面可以看到“交易单”，默认会在url传回商品token、购买者编号PayerID，也只有传回这两个参数。墨尔的接口方法从请求对象中获取，就可以拿到，进行对账，确定是哪个定单的返回，其实同步回调，也就是当前定单的返回了)`

1.请求url:

https://pay.meihao.com/prod-api/mh-extend-pay/api/v1/payment

2.请求方式：
POST

3.请求参数：
`{
	"mchId": "AcmNlJcLiQDkiHIUnKTM0fqjwGn8jbUrXfSeiWnGR1_1X6ppwLiPZm_CNsq6dzR-q0At0Q7VD9BRZMm2",
	"notifyUrl": "https://api-more.meihao.com/wechatAuth/wxpay/paypalNotify",
	"outTradeNo": "4569411000179001",
	"productDesc": "【买5送1】清心堂五指毛桃芡实糕",
	"productName": "【买5送1】清心堂五指毛桃芡实糕...",
	"sign": "87e0a9cd9947c0a906951f0a017ff373",
	"totalFee": 1,
	"tradeType": "paypal_pay_sdk",
	"returnUrl": "https://pay.meihao.com/prod-api/mh-extend-pay/api/v1/paypal/successPayRedirect"
}`

字段解释释：

**sign**: 使用md5加密码签名串。

**outTradeNo**: 定单号。

**mchId**：商家id。`paypal支付没有商户帐号的概念，以paypal的app下的client_id作为商户帐号。`

**tradeType**：交易类型，paypal sdk支付：`paypal_pay_sdk`

**notifyUrl**：通知回调业务系统的url,按实际的传。

**totalFee**：支付金额。单位分。

其它的有什么字段要似，就补上。

## MD5签名规则：所有提交字段(包含密钥key字段；排除sign签名字段、value为空的字段)，按key升序排列，然后拼接字符串。格式：key1=value1&key2=value2&key3=value3&......，得到签名数据，然后进行MD5加密。得到加密码串，赋给sign字段，一起提交。

例文1：`{
	"mchId": "AcmNlJcLiQDkiHIUnKTM0fqjwGn8jbUrXfSeiWnGR1_1X6ppwLiPZm_CNsq6dzR-q0At0Q7VD9BRZMm2",
	"notifyUrl": "https://api-more.meihao.com/wechatAuth/wxpay/paypalNotify",
	"outTradeNo": "4569411000179001",
	"productDesc": "【买5送1】清心堂五指毛桃芡实糕",
	"productName": "【买5送1】清心堂五指毛桃芡实糕...",
	"sign": "87e0a9cd9947c0a906951f0a017ff373",
	"totalFee": 1,
	"tradeType": "paypal_pay_sdk",
	"returnUrl": "https://pay.meihao.com/prod-api/mh-extend-pay/api/v1/paypal/successPayRedirect"
}`

例子签名待签名数据：appId=wxacc9c5abaaf4de71&key=wYTwbzElh4ypJgPkBrwwQfDFQR8jzSho&mchId=6666000158447075&notifyUrl=https://api-more.meihao.com/wechatAuth/wxpay/paypalNotify&openId=otZLs4t1HkF2CbLRPVAyhXzXaqbw&outTradeNo=4569411000171002&productDesc=【买5送1】清心堂五指毛桃芡实糕&productName=【买5送1】清心堂五指毛桃芡实糕...&totalFee=1&tradeType=DG_PAY_WX_XCX

生成新的签名串：ebfae81c286b4b16e30d15c1f54b7c7d

3.返回：

成功返回：

`**前端获取返回的 pay_result(定单支付链)，进行支付就可以了：**`

`{
	"code": 200,
	"data": {
		"amount": 1,
		"out_trade_no": "4569411000179001",
		"pay_type": 1,
		"product_name": "【买5送1】清心堂五指毛桃芡实糕...",
		"collection_name": "墨尔智慧",
		"pay_result": "https://www.paypal.com/checkoutnow?token=28A88678S16617836"
	},
	"msg": "申请支付成功"
}`

失败返回：
`{
	"code": 500,
	"msg": "traceId_pay_172.16.100.97_4569411000171002, 申请支付 不处理未定义的支付类型：tradeType = PAYPAY_SDK_XXX"
}`

或：`{
	"code": 400,
	"msg": "traceId_pay_172.16.100.97_4569411000171002, 申请支付 验签结果,失败: 申请支付 验签失败，签名结果不一致"
}`