創建代收訂單

創建一個新的代收（收款）訂單。

請求資訊

項目	值
方法	POST
路徑	/gateway/api/v1/payments
Content-Type	application/json

請求參數

參數名	類型	必填	說明
platform_id	string	✅	平台商戶 ID
service_id	string	✅	服務類型，參考 服務 ID 列表
merchant_order_id	string	✅	商戶訂單號，須唯一
amount	number	✅	訂單金額
notify_url	string	✅	回調通知 URL
return_url	string	❌	支付完成後跳轉 URL
extra_info	string	❌	額外資訊，回調時原樣返回
sign	string	✅	簽名，參考 簽名規範

請求範例

{
  "platform_id": "10001",
  "service_id": "CN_BANK_DEPOSIT",
  "merchant_order_id": "ORDER_20231218_001",
  "amount": 100000,
  "notify_url": "https://your-domain.com/api/callback",
  "return_url": "https://your-domain.com/payment/result",
  "sign": "a1b2c3d4e5f6..."
}

響應參數

參數名	類型	說明
code	number	狀態碼，0 表示成功
message	string	狀態訊息
data.order_id	string	系统订单号
data.payment_url	string	支付頁面 URL
data.expire_time	string	訂單過期時間

響應範例

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "DP20231218123456789",
    "payment_url": "https://pay.your-domain.com/checkout/DP20231218123456789",
    "expire_time": "2023-12-18T15:30:00+08:00"
  }
}

錯誤碼

錯誤碼	說明
1001	參數錯誤
1002	簽名驗證失敗
1003	商戶不存在
1004	服務未開通
1005	訂單號重複