一些重要的支付宝沙箱文档及网址
- 支付宝开放平台：https://open.alipay.com/
- 简单介绍：https://www.yuque.com/chenqiu/alipay-node-sdk/guide
- 支付宝开放平台API：https://open.alipay.com/api
- 支付宝开放平台文档：https://opendocs.alipay.com/home
支付流程介绍
图片来自支付宝开放平台。
上面的流程图，已经大致描述了发起支付的过程，这里笔者用自己的语言，详细地转化一下：
下单。这里的下单，在项目中往往表现为用户确认了订单、然后选择支付方式、点击立即支付，即当用户点击“立即支付”时才产生的动作。 这一步要发送一个请求到我们的服务器，假如说系统中立即支付的API路径是/pay，参数一般就是订单包含的订单项，如商品id、购买数量、优惠券id等。
服务器端处理用户的下单请求。在这一步，是业务比较多的一步，也是关键步骤。我们根据客户端传来的商品id、数量、优惠券等参数，计算出每一个商品的单价、订单的总金额等（金额是不应该由客户端直接传的，应该由服务器端计算，更安全）。再生成一个订单号。然后调用一个接口，把这些参数（如商品名称、支付金额、订单号等）打包传给支付宝，也就是对应上图中的1.1。
依然是处理用户的下单请求，只是我嫌段落太长，换一段。在图中的1.1，我们调用了支付宝的接口。其实图中还少了一步1.2，那就是支付宝会返回一段html文档，就是大家经常看到的带二维码的PC端支付页面。请注意，到这一步，对客户端来说依然是在访问/pay接口，因为我们还没有对请求作出响应，只是一直在和支付宝交互罢了。所以，我们把支付宝返回的html文档作为响应信息，返回给客户端，客户端直接加载这一段html文档，用户就看到了一个支付页面。
到了这里，对应上图中的2、3、4、5步，和我们的服务器就没关系了，完全是用户在进行支付的过程。
到了第6步，用户支付完成，支付宝会跳转到一个我们指定的网页，这个网页一般是我们自定义的页面，比如在网页上显示“您已成功购买xxx商品，感谢您的支持”等。注意，此处的returnUrl只是跳转到我们自定义的友好页面，告诉用户支付成功了，只做展示用途，并非真正的支付回调。
到了第7步，支付宝会调用我们指定的回调API接口，将一些参数传给我们，如交易流水号、订单号，我们可以根据这些信息查询交易是否真的成功了(第8步)，从而执行后续的业务，比如将订单状态变为已支付、给用户增加积分、扣减优惠券……等。
沙箱环境简介与配置
支付宝有一个供开发者测试使用的沙箱环境，会提供一个沙箱版的支付宝app、一个商家账户、一个买家账户。有了这个，可以让我们跳过商家入驻、企业资质审核等过程，开箱即用，降低了学习成本。
现在，让我们简单的配置沙箱环境。
1、进入到支付宝支付官网，用你自己的支付宝扫码登录，再点击进入管理中心。
2、点击进入沙箱应用。
此时就到了沙箱应用的控制台，进入之后要创建一个应用。
3、生成安全密钥
此部分的官方文档为：https://opendocs.alipay.com/common/02kipl。
进入该网址下载支付宝官方的密钥生成工具应用。
进入应用后，根据开发语言选择密钥格式和密钥长度。注意此处要选择RSA2。
然后点击生成密钥，工具会自动生成商户应用公钥（public_key）和应用私钥（private_key）。
这里有几个密钥要注意一下：
- 应用公钥（public key）：需提供给支付宝账号管理者上传到支付宝开放平台。
- 应用私钥（private key）：由开发者自己保存，需填写到代码中供签名时使用。
- 支付宝公钥：支付宝提供的公钥，用于接入服务。
还有要注意的事情为：
- 生成的私钥需妥善保管，避免遗失，不要泄露。
- 密钥和应用（APPID）一一对应，即开发者需要为名下的每个应用分别设置密钥，且不同应用的密钥不能混用。
4、配置安全密钥
用上述的工具生成密钥之后，要把应用公钥上传到支付宝开发者平台，如图点击切换为自定义密钥。
在弹出的窗口，把刚才生成的应用公钥复制粘贴进去，点击确定，就可以看到这个界面了，注意这里的支付宝公钥：
5、下载支付宝沙箱APP及账号管理
“支付宝沙箱APP”可以在官网找到，直接下载即可。
在沙箱控制台当中，点击“沙箱账号”，就可以看到当前应用对应的沙箱账号，用来登录我们的沙箱版支付宝APP进行测试。
上面的是商家的账号，下面是买家的测试账号。
6、学会看文档
在支付宝开放平台，点击文档，即可查看文档。如果要查看API就点击API，如果要查看技术的总体介绍，就点击文档。
比如点击API，然后选择场景：
比如说选择电脑网站支付，就可以查看到这些API列表。点击后面的查看文档就可以查看到这些API详细的参数。
其实不同场景的API是差不多的，例如“下单并支付页面”的接口，电脑网站支付的API接口路径为“alipay.trade.page.pay”,而手机端的则为“alipay.trade.wap.pay”。
7、开始写代码
下载依赖
npm install alipay-sdk
封装SDK
appId在上面进入沙箱控制台的时候就可以看到了。
注意下面的支付宝公钥和应用私钥，都是步骤二里的。
const AlipaySdk = require('alipay-sdk').default; // 引入 SDK
const alipaySdk = new AlipaySdk({
appId: '此处要修改', // 开放平台上创建应用时生成的 appId
signType: 'RSA2', // 签名算法,默认 RSA2
gateway: 'https://openapi.alipaydev.com/gateway.do', // 支付宝网关地址 ，沙箱环境下使用时需要修改 正式线上的时候换成 https://openapi.alipay.com/gateway.do
alipayPublicKey: '此处要修改', // 支付宝公钥，需要对结果验签时候必填
privateKey: '此处要修改', // 应用私钥字符串
});
module.exports = alipaySdk;
//正式环境只要把上述换成正式的就可以了
创建提交交易信息的表单
注意这里要编写的参数是在上面的API文档里可以查看到。
const AlipayFormData = require("alipay-sdk/lib/form").default;
const formData = new AlipayFormData();
formData.setMethod('get');
formData.addField('bizContent', {
outTradeNo: '15693801273225', // 商户订单号,64个字符以内、可包含字母、数字、下划线,且不能重复
productCode: 'FAST_INSTANT_TRADE_PAY', // 销售产品码，与支付宝签约的产品码名称,仅支持FAST_INSTANT_TRADE_PAY
totalAmount: '0.01', // 订单总金额，单位为元，精确到小数点后两位
subject: '商品', // 订单标题
body: '商品详情', // 订单描述
});
// 表示异步通知回调,
formData.addField('notifyUrl', 'https://www.baidu.com');
// 付款成功的跳转页面
formData.addField('returnUrl', 'https://www.bilibili.com');
这里的notifyUrl和returnUrl要做一个区分：
- notifyUrl：消息回调的接口，当付款成功，支付宝会发送成功信息到我们的项目当中，告诉我们付款成功了，即我们项目自己定义的接口，需要公网能够访问到的地址，即**项目要上线。**如果是自己本地的测试项目，可以配置内网穿透。
- returnUrl：付款成功之后，页面会自动跳转的嘛，returnUrl就表示这个跳转的地址。
发送交易请求：调用SDK的exec()方法
该方法有三个参数：
const result = await alipaySdk.exec(method, params, options);
- method:String 调用的 Api，比如 alipay.system.oauth.token
- params:Api 的请求参数（包含“公共请求参数”和“业务参数”）
- options:可以传入我们的formData
- 更详细请查看：https://www.yuque.com/chenqiu/alipay-node-sdk/exec
具体实例：
// 付款API:https://opendocs.alipay.com/apis/api_1/alipay.trade.pay?scene=32
async function test() {
const result = await alipaySdk.exec( // result 为可以跳转到支付链接的 url
'alipay.trade.page.pay', // 统一收单下单并支付页面接口
{}, // api 请求的参数（包含“公共请求参数”和“业务参数”）
{
formData: formData
},
);
console.log(result)
}
test()
到这里，我们查看一下这个result是什么？
把这个复制到浏览器里，咱们就来到了支付界面啦，这里就可以登录我们的沙箱买家测试账号进行付款了：
代码跳转的话代码如下：
goPay() {
let data = {
orderId: 't454545212121' //随机生成唯一的就行了这个 自己找吧
}
var instance = this.$axios.create({headers: {'content-type': 'application/x-www-form-urlencoded'}});
// 代理到 http://localhost:3000/api/pcpay
instance.post(`http://localhost:3000/api/pcpay`, this.$qs.stringify(data)).then(res =>{
this.data=res;
window.open(res.data.result)
});
}
付款完毕之后，就会跳转到returnUrl的网址喽。
有没有发现method就是API文档里的接口名称？没错！
咱们上面调用了“alipay.trade.page.pay”这个接口来下单与付款，下面我们再来看看如何用“alipay.trade.query”查看这个订单的状态。
async function check() {
let outTradeNo = "15693801273225";
const formData = new AlipayFormData();
formData.setMethod('get');
formData.addField('bizContent', {
outTradeNo
});
// 通过该接口主动查询订单状态
// 查询订单状态：https://opendocs.alipay.com/apis/api_1/alipay.trade.query?scene=23
let result = await alipaySdk.exec(
'alipay.trade.query', {}, {
formData: formData
},
);
console.log(result)
}
check()
这里的result还是一个网址，我们需要axios请求这个网址，才能查看订单状态：
/**
* 添加购物车提交订单支付宝支付后查询订单状态是否成功 */
router.post('/api/member/queryOrderAlipay', (req, res) => {
let orderId=req.body.orderId
const formData = new AlipayFormData();
formData.setMethod('get');
formData.addField('bizContent', {
orderId
});
// 通过该接口主动查询订单状态
const result = alipaySdk.exec(
'alipay.trade.query',
{},
{ formData: formData },
);
axios({
method: 'GET',
url: result
})
.then(data => {
let r = data.data.alipay_trade_query_response;
if(r.code === '10000') { // 接口调用成功
switch(r.trade_status) {
case 'WAIT_BUYER_PAY':
res.send(
{
"success": true,
"message": "success",
"code": 200,
"timestamp": (new Date()).getTime(),
"result": {
"status":0,
"massage":'交易创建，等待买家付款'
}
}
)
break;
case 'TRADE_CLOSED':
res.send(
{
"success": true,
"message": "success",
"code": 200,
"timestamp": (new Date()).getTime(),
"result": {
"status":1,
"massage":'未付款交易超时关闭，或支付完成后全额退款'
}
}
)
break;
case 'TRADE_SUCCESS':
res.send(
{
"success": true,
"message": "success",
"code": 200,
"timestamp": (new Date()).getTime(),
"result": {
"status":2,
"massage":'交易支付成功'
}
}
)
break;
case 'TRADE_FINISHED':
res.send(
{
"success": true,
"message": "success",
"code": 200,
"timestamp": (new Date()).getTime(),
"result": {
"status":3,
"massage":'交易结束，不可退款'
}
}
)
break;
}
} else if(r.code === '40004') {
res.send('交易不存在');
}
})
.catch(err => {
res.json({
msg: '查询失败',
err
});
});
})
状态码可以通过上面API文档查看：
参考链接
- https://blog.csdn.net/rapguys/article/details/115763799
- https://blog.51cto.com/lllomh/3037337
