請求示例
PassToPay API 是基於 REST 風格組織的。我們的 API 使用可預測的資源導向 URL,接受表單編碼的請求主體,返回 JSON 編碼的響應,並使用標準的 HTTP 響應碼、身份驗證。
下圖以客戶使用支付寶掃碼支付為例,展示各個系統之間的交互流程:

關鍵字定義和術語
Merchant
PassToPay'的商家(可能意味著伺服器或網站本身)
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常用請求參數
API常用回應參數
code
int
0
成功 (0) 其他 - 處理有誤,具體錯誤詳見 msg 字段
msg
string
format error
結果資訊 或具體錯誤原因,例如:簽章失敗、參數格式驗證錯誤
sign
string
4A5078DABBCE0D9C4
資料內容的簽名。如果資料為空,則不會傳回。
data
string
{}
傳回 json 格式的結果數據
API常用回應參數代碼定義
0
成功
9999
異常,具體錯誤詳見msg字段
Last updated