如何使用 RESTful API 实现微信支付-JavaScript中文网-JavaScript教程资源分享门户

在现代互联网应用中，支付是一个非常重要的功能。微信支付作为目前中国最流行的支付方式之一，被广泛应用于各种电商、社交、游戏等场景。本文将介绍如何使用 RESTful API 实现微信支付，从而为前端开发者提供一种快速、可靠的支付解决方案。

什么是 RESTful API

RESTful API 是一种基于 HTTP 协议的 Web API 设计风格，它通过 URL、HTTP 动词（GET、POST、PUT、DELETE 等）、HTTP 头部信息等方式，实现客户端与服务器之间的数据交互。RESTful API 的特点包括以下几点：

每个 URL 代表一种资源；
客户端与服务器之间，传递的是资源的表述；
使用 HTTP 动词来操作资源；
支持多种数据格式，如 JSON、XML 等。

在微信支付中，RESTful API 是实现支付功能的重要组成部分，通过调用微信支付提供的 API，可以实现支付订单的生成、查询、关闭等操作。

步骤一：申请微信支付商户号

在使用微信支付之前，需要先申请微信支付的商户号。商户号是微信支付的唯一标识，可以用于发起支付请求、接收支付通知等操作。申请商户号的具体步骤可以参考微信支付官方文档。

步骤二：生成支付订单

在商户号申请完成后，可以开始生成支付订单。生成支付订单需要调用微信支付提供的统一下单接口，该接口的 URL 为 https://api.mch.weixin.qq.com/pay/unifiedorder，请求方式为 POST。请求参数需要包含以下几个字段：

appid：微信支付分配的公众账号 ID（或小程序 ID）
mch_id：微信支付分配的商户号
nonce_str：随机字符串，不长于 32 位
sign：签名，详见下文
body：商品描述
out_trade_no：商户订单号
total_fee：订单总金额，单位为分
spbill_create_ip：用户端实际 IP
notify_url：接收微信支付异步通知回调地址
trade_type：交易类型，如 JSAPI、NATIVE、APP 等
openid：用户标识，trade_type 为 JSAPI 时必传

以上字段中，签名是最重要的一个字段，它用于验证请求的合法性。签名的生成方式可以参考微信支付官方文档中的签名算法。

生成支付订单的示例代码如下：

// javascriptcn.com 代码示例
const request = require('request')
const crypto = require('crypto')

const appid = 'your_appid'
const mch_id = 'your_mch_id'
const nonce_str = Math.random().toString(36).substr(2, 15)
const key = 'your_key'

const params = {
  appid,
  mch_id,
  nonce_str,
  body: 'test',
  out_trade_no: 'test' + new Date().getTime(),
  total_fee: 1,
  spbill_create_ip: '127.0.0.1',
  notify_url: 'http://localhost:3000/notify',
  trade_type: 'NATIVE',
}

const sign = Object.keys(params)
  .sort()
  .map(key => `${key}=${params[key]}`)
  .join('&')
  + `&key=${key}`

params.sign = crypto.createHash('md5').update(sign).digest('hex').toUpperCase()

request.post({
  url: 'https://api.mch.weixin.qq.com/pay/unifiedorder',
  body: `<xml>${Object.keys(params).map(key => `<${key}>${params[key]}</${key}>`).join('')}</xml>`
}, (err, response, body) => {
  console.log(body)
})

步骤三：生成支付二维码

生成支付订单后，需要将订单信息返回给前端，以便生成支付二维码。支付二维码是用户扫描后进入微信支付页面的重要入口。生成支付二维码需要使用微信支付提供的支付二维码生成接口，该接口的 URL 为 https://api.mch.weixin.qq.com/pay/unifiedorder，请求方式为 POST。请求参数需要包含以下几个字段：

appid：微信支付分配的公众账号 ID（或小程序 ID）
mch_id：微信支付分配的商户号
nonce_str：随机字符串，不长于 32 位
sign：签名，详见下文
product_id：商品 ID，trade_type 为 NATIVE 时必传

生成支付二维码的示例代码如下：

// javascriptcn.com 代码示例
const request = require('request')
const crypto = require('crypto')
const QRCode = require('qrcode')

const appid = 'your_appid'
const mch_id = 'your_mch_id'
const nonce_str = Math.random().toString(36).substr(2, 15)
const key = 'your_key'

const params = {
  appid,
  mch_id,
  nonce_str,
  product_id: 'test',
}

const sign = Object.keys(params)
  .sort()
  .map(key => `${key}=${params[key]}`)
  .join('&')
  + `&key=${key}`

params.sign = crypto.createHash('md5').update(sign).digest('hex').toUpperCase()

request.post({
  url: 'https://api.mch.weixin.qq.com/tools/tradepay/entrustweb',
  body: `<xml>${Object.keys(params).map(key => `<${key}>${params[key]}</${key}>`).join('')}</xml>`
}, (err, response, body) => {
  QRCode.toDataURL(body, (err, url) => {
    console.log(url)
  })
})

步骤四：处理支付结果

处理支付结果是整个支付流程的最后一步，也是最为重要的一步。在支付成功后，微信支付会异步通知商户服务器支付结果，商户服务器需要对支付结果进行处理，并返回处理结果。处理支付结果需要使用微信支付提供的支付结果通知接口，该接口的 URL 为 https://api.mch.weixin.qq.com/pay/unifiedorder，请求方式为 POST。请求参数需要包含以下几个字段：

appid：微信支付分配的公众账号 ID（或小程序 ID）
mch_id：微信支付分配的商户号
nonce_str：随机字符串，不长于 32 位
sign：签名，详见下文
out_trade_no：商户订单号
transaction_id：微信支付订单号
result_code：业务结果，SUCCESS 或 FAIL
total_fee：订单总金额，单位为分

处理支付结果的示例代码如下：

// javascriptcn.com 代码示例
const express = require('express')
const bodyParser = require('body-parser')
const crypto = require('crypto')

const key = 'your_key'

const app = express()
app.use(bodyParser.xml())

app.post('/notify', (req, res) => {
  const params = req.body.xml
  const sign = Object.keys(params)
    .filter(key => key !== 'sign')
    .sort()
    .map(key => `${key}=${params[key]}`)
    .join('&')
    + `&key=${key}`

  if (crypto.createHash('md5').update(sign).digest('hex').toUpperCase() === params.sign) {
    if (params.result_code === 'SUCCESS') {
      // 处理支付成功逻辑
    } else {
      // 处理支付失败逻辑
    }
  }

  res.send('<xml><return_code><![CDATA[SUCCESS]]></return_code></xml>')
})

app.listen(3000)

总结

本文介绍了如何使用 RESTful API 实现微信支付，包括生成支付订单、生成支付二维码、处理支付结果等步骤。通过本文的学习，前端开发者可以了解到微信支付的基本流程和实现方式，从而为自己的项目提供一种可靠的支付解决方案。

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/6554b4aed2f5e1655de88965