跳到內文

建立 GMPay 訂單 ​

POSThttps://pay.example.com/payments/gmpay/v1/order/create-transaction

請求範例 ↓

在商戶伺服器上簽章,建立訂單後引導買家開啟 payment_url。token 與 network 必須同時傳入,也可同時省略,讓買家在收銀台選擇。

請求參數 ​

欄位型別必填說明
pidstring是商戶 PID,用於查詢 API Key,並參與簽名。
order_idstring是商戶訂單號,最長 32 字元,不能重複。
currencystring是法幣幣種,如 cny、usd。
tokenstring條件必填收款幣種,如 usdt、trx、usdc、sol。GMPay 可與 network 同時省略以建立狀態 4 佔位訂單。
networkstring條件必填收款網路,如 tron、solana、ethereum、binance、polygon、plasma。GMPay 可與 token 同時省略以建立狀態 4 佔位訂單。
amountnumber是法幣金額,必須大於 0.01。
notify_urlstring是支付成功非同步回撥地址。
redirect_urlstring否支付完成後的同步跳轉地址。
namestring否商品/訂單名稱。
payment_typestring否GMPay 相容欄位,不要求必須傳;如果傳了非空值,必須參與 GMPay signature 計算。普通 GMPay 不傳時後臺會存為 Gmpay;傳 Epay(大小寫不敏感)會統一存為 Epay 並使用 EPay 回撥格式,且 PID 必須是數字。
signaturestring是64 位小寫十六進位制 GMPay HMAC-SHA256 簽名。

範例使用示範金鑰 epusdt_secret_key 簽章。變更參數或商戶金鑰後,請在伺服器重新簽章。

相關文件 ​

回應

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data object

    介面回傳的資料,失敗時為 null。

    • trade_id string
    • order_id string
    • status integer
    • expiration_time integer
    • payment_url string
  • request_id string

    可用於追蹤記錄的請求識別碼。

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data null

    介面回傳的資料,失敗時為 null。

  • request_id string

    可用於追蹤記錄的請求識別碼。

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data null

    介面回傳的資料,失敗時為 null。

  • request_id string

    可用於追蹤記錄的請求識別碼。

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data null

    介面回傳的資料,失敗時為 null。

  • request_id string

    可用於追蹤記錄的請求識別碼。

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data null

    介面回傳的資料,失敗時為 null。

  • request_id string

    可用於追蹤記錄的請求識別碼。

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data null

    介面回傳的資料,失敗時為 null。

  • request_id string

    可用於追蹤記錄的請求識別碼。

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data null

    介面回傳的資料,失敗時為 null。

  • request_id string

    可用於追蹤記錄的請求識別碼。

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data null

    介面回傳的資料,失敗時為 null。

  • request_id string

    可用於追蹤記錄的請求識別碼。

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data null

    介面回傳的資料,失敗時為 null。

  • request_id string

    可用於追蹤記錄的請求識別碼。

application/json
回應欄位
  • status_code integer

    業務結果碼,可用於判斷原因。

  • message string

    供閱讀的結果說明。

  • data null

    介面回傳的資料,失敗時為 null。

  • request_id string

    可用於追蹤記錄的請求識別碼。

error-codes.json ↓