前言

微信支付是由微信及財付通聯(lián)合推出的移動支付創(chuàng)新產(chǎn)品。如今，隨著微信支付的全面開放，相關需求也越來越多，很多開發(fā)人員進行微信支付開發(fā)及商家申請微信支付時，面臨著諸多疑惑。

要想開發(fā)順利進行，首先要對業(yè)務流程有個清晰的認識。這里以微信公眾號支付為例，因此也借用微信支付官方文檔中的業(yè)務流程圖：

接下來來關注幾個開發(fā)過程中的關鍵點，包括：

      1、生成商戶訂單與調(diào)用統(tǒng)一下單 API

      2、微信服務器交互的數(shù)據(jù)格式

      3、公眾號支付下網(wǎng)頁內(nèi)通過 JS-API 調(diào)起支付

      4、異步通知商戶支付結(jié)果（回調(diào)） 

一、生成商戶訂單與調(diào)用統(tǒng)一下單 API

這對應業(yè)務流程中的第 4 和 第 5 步，商戶后臺首先為用戶生成訂單，然后調(diào)用微信的【統(tǒng)一下單】接口向微信支付系統(tǒng)提交訂單。這里有一個關鍵點就是簽名的生成。

簡單來講分為以下幾個步驟：

      1、將所有有效參數(shù)以“k=v”的形式進行拼接，有效參數(shù)是指非空參數(shù)，也就是說如果參數(shù)為空，則不參與簽名；

      2、將所有的“k=v”對用“&”連接，得到“k1=v1&k2=v2&k3=v3”這樣的字符串；

      3、將微信支付 API 密鑰 拼接在最后，如“k1=v1&k2=v2&k3=v3&key=secret”；

      4、對整體進行 MD5 運算，即得到簽名。

這種簽名方法有一個高大上的名字叫做 HMAC（Hash-based Message Authentication Code，基于哈希的消息碼）?；诖怂悸罚梢詫崿F(xiàn)如下簽名方法：

def gen_sign(params, key):
  """
  簽名生成函數(shù)
 
  :param params: 參數(shù)，dict 對象
  :param key: API 密鑰
  :return: sign string
  """
 
  param_list = []
  for k in sorted(params.keys()):
    v = params.get(k)
    if not v:
      # 參數(shù)的值為空不參與簽名
      continue
    param_list.append('{0}={1}'.format(k, v))
  # 在最后拼接 key
  param_list.append('key={}'.format(key))
  # 用 & 連接各 k-v 對，然后對字符串進行 MD5 運算
  return md5('&'.join(param_list).encode('utf8')).hexdigest()

參與簽名的參數(shù)中有一個隨機字符串，在 Python 中有很多方法，當然也可以利用 uuid 庫來生成：

def gen_nonce_str():
  """
  生成隨機字符串，有效字符a-zA-Z0-9
 
  :return: 隨機字符串
  """
 
  return ''.join(str(uuid.uuid4()).split('-'))

二、微信服務器交互的數(shù)據(jù)格式

微信服務器與商戶服務器之間采用 XML 格式進行交互，這就涉及到與語言原生數(shù)據(jù)類型進行轉(zhuǎn)換以方便處理。交互的數(shù)據(jù)參數(shù)都是 key-value 的形式，因此在 Python 中使用字典會更加方便。而要解析 XML，也有一大把第三方庫供使用，比如 BeautifulSoup。

以下是具體實現(xiàn)：

def trans_xml_to_dict(xml):
  """
  將微信支付交互返回的 XML 格式數(shù)據(jù)轉(zhuǎn)化為 Python Dict 對象
 
  :param xml: 原始 XML 格式數(shù)據(jù)
  :return: dict 對象
  """
 
  soup = BeautifulSoup(xml, features='xml')
  xml = soup.find('xml')
  if not xml:
    return {}
 
  # 將 XML 數(shù)據(jù)轉(zhuǎn)化為 Dict
  data = dict([(item.name, item.text) for item in xml.find_all()])
  return data
 
 
def trans_dict_to_xml(data):
  """
  將 dict 對象轉(zhuǎn)換成微信支付交互所需的 XML 格式數(shù)據(jù)
 
  :param data: dict 對象
  :return: xml 格式數(shù)據(jù)
  """
 
  xml = []
  for k in sorted(data.keys()):
    v = data.get(k)
    if k == 'detail' and not v.startswith('<![CDATA['):
      v = '<![CDATA[{}]]>'.format(v)
    xml.append('<{key}>{value}</{key}>'.format(key=k, value=v))
  return '<xml>{}</xml>'.format(''.join(xml))

注意 detail 參數(shù)，即商品詳情，其值為 JSON 格式，在轉(zhuǎn)換為 XML 數(shù)據(jù)時應前注意使用 CDATA 標簽將其保護起來。

如：

<detail><![CDATA[{"goods_detail": [{"wxpay_goods_id": "10010001", "price": 1, "goods_num": 1, "goods_name": "\\u82f9\\u679c", "goods_id": "10010001"}, {"wxpay_goods_id": "10010002", "price": 1, "goods_num": 1, "goods_name": "\\u9999\\u8549", "goods_id": "10010002"}]}]]></detail>

三、公眾號支付下網(wǎng)頁內(nèi)通過 JS-API 調(diào)起支付

這一點對應業(yè)務流程中的第 7 步。之所以提及它是因為微信官方文檔在此給開發(fā)者挖了一個坑（至少截至我在寫這篇文章時是的），就是在“網(wǎng)頁端調(diào)起支付API”中關于 JS 的示例代碼是采用的 WeixinJSBridge，這在很早以前就是 Deprecated 的“玩意兒”，如今更是已經(jīng)不可用了。正確的做法是使用 JS-SDK，可以參考微信公眾號的 wiki。

使用 JS-SDK 前需要先調(diào)用 config，這里也包含一個簽名，但注意這個簽名與之前微信支付的簽名并不相干。其首先需要用微信公眾號的 APPID 和 APPKEY 來換取 access_token，然后用該 access_token 調(diào)用 JS-SDK 換取 ticket 的接口得到 ticket，最后再使用該 ticket 和用戶當前頁面的 URI 通過 sha1 運算生成簽名。

在此之后，即可調(diào)用 wx.chooseWXPay 來調(diào)起支付，這里也有一個坑：timestamp。wx.chooseWXPay 中的參數(shù)要求 timestamp 是全小寫。而微信支付中簽名時要求 timestamp 中的“s”是大寫。真的是要傻傻分不清了。 

四、異步通知商戶支付結(jié)果（回調(diào)）

最后是關于異步回調(diào)，對應業(yè)務流程中的第 10 步。在用戶支付操作完成后，微信服務器會通過回調(diào)的形式告知商戶服務器支付結(jié)果。回調(diào)的地址與【統(tǒng)一下單】中定義的 notify_url 一致。當接收到回調(diào)時，首先應驗證簽名的有效性以保證“來源可靠”，然后可以通過回調(diào)中所帶的 openid、out_trade_no 等來定位唯一訂單。

總結(jié)

微信支付還有很多種形式，在業(yè)務流程上也不盡相同。不過只要能玩轉(zhuǎn)其中一種，其他的也基本來說能很快實現(xiàn)。另外，支付功能的實現(xiàn)涉及業(yè)務流程中的安全性，因此一定要注意理清業(yè)務流程，并卡好各個關鍵結(jié)點。以上就是本文的全部內(nèi)容，希望對大家使用Python開發(fā)微信支付能有所幫助。

最新評論