跳到內文

建立易支付訂單 ​

POSThttps://pay.example.com/payments/epay/v1/order/create-transaction/submit.php

請求範例 ↓

透過 GET 查詢字串或 POST 表單提交已簽章的參數。MD5 驗章並成功建立訂單後,閘道透過 HTTP 302 導向收銀台。

請求參數 ​

欄位位置型別必填說明
pidquery/formstring是商戶 PID。建議使用數字 PID;EPay 回撥會按數字 PID 輸出。
moneyquery/formnumber是法幣金額。
out_trade_noquery/formstring是商戶訂單號。
notify_urlquery/formstring是非同步回撥地址。
return_urlquery/formstring否支付完成後的同步跳轉地址。
namequery/formstring否商品/訂單名稱。
typequery/formstring否僅支援空值、alipay,或當前已啟用並可收款的 token.network selector(如 usdt.tron)。推薦使用小寫 alipay。
tokenquery/formstring否可選收款幣種。僅在 type 不是命中的 selector 時參與解析;傳了就必須參與 EPay 簽名。
networkquery/formstring否可選收款網路。僅在 type 不是命中的 selector 時參與解析;傳了就必須參與 EPay 簽名。
currencyquery/formstring否可選法幣幣種。優先順序高於後臺 epay.default_currency;傳了就必須參與 EPay 簽名。
signquery/formstring是EPay 簽名。
sign_typequery/formstring否通常為 MD5。

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

相關文件 ​

回應

LocationLocation: /pay/checkout-counter/20260523171652123456001
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 ↓