請求示例

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常用請求參數

參數
類型
描述

sign

string

請參閱**請求簽名**

API常用回應參數

參數
類型
例子
描述

code

int

0

成功 (0) 其他 - 處理有誤,具體錯誤詳見 msg 字段

msg

string

format error

結果資訊 或具體錯誤原因,例如:簽章失敗、參數格式驗證錯誤

sign

string

4A5078DABBCE0D9C4

資料內容的簽名。如果資料為空,則不會傳回。

data

string

{}

傳回 json 格式的結果數據

API常用回應參數代碼定義

Value
Description

0

成功

9999

異常,具體錯誤詳見msg字段

Last updated