建立 GMPay 訂單
POST
https://pay.example.com/payments/gmpay/v1/order/create-transaction在商戶伺服器上簽章,建立訂單後引導買家開啟 payment_url。token 與 network 必須同時傳入,也可同時省略,讓買家在收銀台選擇。
請求參數
| 欄位 | 型別 | 必填 | 說明 |
|---|---|---|---|
pid | string | 是 | 商戶 PID,用於查詢 API Key,並參與簽名。 |
order_id | string | 是 | 商戶訂單號,最長 32 字元,不能重複。 |
currency | string | 是 | 法幣幣種,如 cny、usd。 |
token | string | 條件必填 | 收款幣種,如 usdt、trx、usdc、sol。GMPay 可與 network 同時省略以建立狀態 4 佔位訂單。 |
network | string | 條件必填 | 收款網路,如 tron、solana、ethereum、binance、polygon、plasma。GMPay 可與 token 同時省略以建立狀態 4 佔位訂單。 |
amount | number | 是 | 法幣金額,必須大於 0.01。 |
notify_url | string | 是 | 支付成功非同步回撥地址。 |
redirect_url | string | 否 | 支付完成後的同步跳轉地址。 |
name | string | 否 | 商品/訂單名稱。 |
payment_type | string | 否 | GMPay 相容欄位,不要求必須傳;如果傳了非空值,必須參與 GMPay signature 計算。普通 GMPay 不傳時後臺會存為 Gmpay;傳 Epay(大小寫不敏感)會統一存為 Epay 並使用 EPay 回撥格式,且 PID 必須是數字。 |
signature | string | 是 | 64 位小寫十六進位制 GMPay HMAC-SHA256 簽名。 |
範例使用示範金鑰 epusdt_secret_key 簽章。變更參數或商戶金鑰後,請在伺服器重新簽章。
相關文件
回應
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
dataobject介面回傳的資料,失敗時為 null。
trade_idstringorder_idstringstatusintegerexpiration_timeintegerpayment_urlstring
request_idstring可用於追蹤記錄的請求識別碼。
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
datanull介面回傳的資料,失敗時為 null。
request_idstring可用於追蹤記錄的請求識別碼。
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
datanull介面回傳的資料,失敗時為 null。
request_idstring可用於追蹤記錄的請求識別碼。
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
datanull介面回傳的資料,失敗時為 null。
request_idstring可用於追蹤記錄的請求識別碼。
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
datanull介面回傳的資料,失敗時為 null。
request_idstring可用於追蹤記錄的請求識別碼。
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
datanull介面回傳的資料,失敗時為 null。
request_idstring可用於追蹤記錄的請求識別碼。
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
datanull介面回傳的資料,失敗時為 null。
request_idstring可用於追蹤記錄的請求識別碼。
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
datanull介面回傳的資料,失敗時為 null。
request_idstring可用於追蹤記錄的請求識別碼。
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
datanull介面回傳的資料,失敗時為 null。
request_idstring可用於追蹤記錄的請求識別碼。
application/json
回應欄位
status_codeinteger業務結果碼,可用於判斷原因。
messagestring供閱讀的結果說明。
datanull介面回傳的資料,失敗時為 null。
request_idstring可用於追蹤記錄的請求識別碼。