👀 了解 PassToPay API

PassToPay API 是基於 REST 風格組織的。我們的 API 使用可預測的資源導向 URL,接受表單編碼的請求主體,返回 JSON 編碼的響應,並使用標準的 HTTP 響應碼、身份驗證。


下圖以客戶使用支付寶掃碼支付為例,展示各個系統之間的交互流程:

關鍵字定義和術語

關鍵字定義
MerchantPassToPay'的商家(可能意味著伺服器或網站本身)
Customer商家的客戶或網路使用者
Deposit Submission商家在存款過程中向網關(Gateway) 提交的有效提交
Deposit Result存款流程完成後,網關傳回商家的結果
Transfer Submission商家在轉帳過程中向網關提交的有效提交
Transfer Result轉帳流程完成後,網關傳回商家的結果
Verification提供給商家用於簽名目的的私鑰

參數規格

關鍵參數描述
sign 每個請求都是由商家唯一的私鑰發出的,主要用於做簽名驗證。
(一個私鑰提供給商家的金鑰,以確保請求是透過該私鑰產生的簽名發送的)
請參閱請求簽名
Merchant ID各商家對應的唯一ID
Transaction amount預設為人民幣交易,單位為分,參數值不能包含小數
Time parameters所有時間參數均使用精確到毫秒的13位數值,如:1622016572190。定時器具體是指從GMT 00:00:00開始的毫秒數從1970年1月1日至今。

API常用請求參數

參數類型描述
signstring請參閱請求簽名

API常用回應參數

參數類型例子描述
codeint0成功 (0)
其他-處理有誤,具體錯誤詳見msg字段
msgstringformat error結果資訊
或具體錯誤原因,例如:簽章失敗、參數格式驗證錯誤
signstring4A5078DABBCE0D9C4資料內容的簽名。如果資料為空,則不會傳回。
datastring{}傳回json格式的結果數據

API常用回應參數代碼定義

ValueDescription
0成功
9999異常,具體錯誤詳見msg字段