要在 PowerBuilder 中串接支付寶「當面付」(掃碼支付),前置作業必須先在支付寶開放平台完成商戶簽約,並設定好應用程式的 App ID 與公私鑰對。這部分請參考支付寶官方文件,本文聚焦於程式實作。
整體流程分三步:把請求參數組成鍵值字串、以商戶私鑰做 RSAwithSHA1 簽名、再把參數連同簽名 POST 到支付寶閘道。
string ls_pubFileName,ls_priFileName n_pbfunc_cryp lnv_cryp ls_priFileName ="D:\pbfunclib_pri.pem"//私鑰文件 string ls_str string ls_appId,ls_secret,ls_biz_content ls_appId ="3434343"//改成你的appid ls_biz_content='{"out_trade_no": "2015020011","scene": "bar_code","auth_code": "'+sle_1.Text+'","subject": "當面付條碼支付","total_amount": "0.01"}' ls_str ="app_id="+ls_appId ls_str +='&biz_content='+ls_biz_content ls_str +='&charset=utf-8' ls_str +='&method=alipay.trade.pay' ls_str +='&sign_type=RSA' ls_str +='×tamp=2016-05-08 11:27:15' ls_str +='&version=1.0' string ls_sigStr blob utf8R utf8R =lnv_cryp.of_str2utf8(ls_str) if lnv_cryp.of_sha1withRsa(ls_priFileName,utf8R,lnv_cryp.HASH_RESULT_DEFAULT,ls_sigStr) then MessageBox("提示","簽名成功:"+ls_sigStr) Else MessageBox("提示","簽名失敗") end if /*驗證簽名可以不需要調用*/ ls_pubFileName ="D:\pbfunclib_pub.pem"//在D盤生成公鑰文件pbfunclib_pub.pem IF Not lnv_cryp.of_RSAVerifyFileSHA1(ls_pubFileName,utf8R,ls_sigStr,lnv_cryp.HASH_RESULT_DEFAULT) Then MessageBox("提示","驗證簽名失敗") else messagebox("","驗證簽名成功") End IF //ls_str +='' n_pbfunc_http lnv_http lnv_http.of_clear()//清空參數 string ls_data ls_data = "app_id="+wf_alipay_urlencode(ls_appId) ls_data += "&biz_content="+wf_alipay_urlencode(ls_biz_content) ls_data += "&charset="+wf_alipay_urlencode("utf-8") ls_data += "&method="+wf_alipay_urlencode("alipay.trade.pay") ls_data += "&sign_type="+wf_alipay_urlencode("RSA") ls_data += "&sign="+wf_alipay_urlencode(ls_sigStr) ls_data += "×tamp="+wf_alipay_urlencode("2016-05-08 11:27:15") ls_data += "&version="+wf_alipay_urlencode("1.0") lnv_http.of_set_URL("https://openapi.alipay.com/gateway.do?"+ls_data) Blob lblb_data string ls_error IF lnv_http.of_post(lblb_data,ls_error) Then string gbkData gbkData = lnv_cryp.of_utf8ToGbk(lblb_data)//由於返回來的是utf-8編碼,直接顯示會亂碼 MessageBox("提示",gbkData+" "+string(lblb_data)) Else MessageBox("提示","執行失敗") End IF
其中 wf_alipay_urlencode 的實作如下:
//ls_str為參數 n_pbfunc_encode lnv_encode string ls_content,ls_reserved//指明不需要編碼的字符 ls_reserved =""//都需要編碼 string ls_sigStr blob utf8R utf8R =lnv_encode.of_str2utf8(ls_str) lnv_encode.of_URIEncode2(utf8R,ls_content) return ls_content
編碼順序決定簽名是否有效。支付寶規定的流程是:先把參數按鍵名做字典序排序、組合成 key=value&key=value 的形式,對這段「未編碼」的字串做簽名,之後才對每個值做 URL 編碼送出。若順序顛倒——先編碼再簽名——伺服端驗簽必定失敗。上面的程式碼在組 ls_str 時依字母序排列(app_id、biz_content、charset、method、sign_type、timestamp、version),正是這個緣故。
時間戳必須是當前時間。範例中寫死 2016-05-08 11:27:15 只是為了示範。實作時應動態產生,格式為 yyyy-MM-dd HH:mm:ss。支付寶對請求有時效性檢查,過期時間戳會被拒絕。
簽名方式已演進。範例使用 RSA(SHA1withRSA),但支付寶現已主推 RSA2(SHA256withRSA),並逐步淘汰 SHA1 簽名。新接入的應用應直接採用 RSA2,把 sign_type 設為 "RSA2" 並改用對應的 SHA256 簽名方法。
auth_code 是掃到的付款碼。biz_content 中的 auth_code 對應商家用「掃碼」設備掃描使用者付款碼時取得的內容(28 開頭的數字串)。若走的是使用者掃商家二維碼的流程,則改用 alipay.trade.precreate 介面並傳 scene 為 "qr_code"。
回應編碼要轉換。支付寶閘道回傳 UTF-8,而 PowerBuilder 傳統應用常使用 ANSI/GBK,因此程式用 of_utf8ToGbk 轉了一次。顯示出來是亂碼時,優先檢查這一步。
金鑰不要寫在程式碼裡。範例把私鑰路徑與 App ID 直接寫死,實務上應移到外部設定檔或環境變數,並限制檔案權限。商戶私鑰外洩等同於金庫鑰匙外洩。
正式環境務必驗證回簽。程式只示範了「本地驗簽」用來自我檢查,但真正關鍵的是驗證支付寶回傳的簽名——這是防止偽造成功通知的必要步驟。同時應核對回傳的金額與 out_trade_no 是否與自己的訂單一致,再更新訂單狀態。當面付通常在支付結果的同步回應中即可取得交易狀態,若有非同步通知(notify_url),也要同樣做驗簽處理。