8.1.2 創建法幣支付訂單

#簡單描述：取得現金（法幣）支付（儲值）訂單

要求方式: POST
請求介面: https://网关域名/wallet-trade-merchant/v1/receive/cash/payment/create
請求媒體類型( JSON 資料格式 )Content-Type: application/json

**註：此類型訂單在回檔過程中，可能因我方平台延遲收到款項而導致訂單逾時，從而產生失敗回檔。但當款項到帳後，系統會自動補發成功回檔。因此，商家只需處理 status = "SUCCESS"（訂單成功）的回檔即可。 **

請求參數

參數名稱	類型	必填	參數意義	參數說明
`key`	`string`	是	商家 key	apiKey
`localOrderId`	`string`	是	商家平臺本地訂單號碼	商家平臺本地產生唯一訂單號碼
`localUserId`	`string`	否	商家平臺本機使用者ID	商家平臺本機使用者ID
`notifyUrl`	`string`	否	回呼位址	下單成功後，由 API 回呼通知商家的位址（回調詳情說明在最下方）
`successRedirectUrl`	`string`	否	跳轉位址	成功後自動跳轉位址
`channelCode`	`string`	是	頻道編碼	透過文件8.1.1介面取得通路編碼（channelCode欄位）
`currency`	`string`	是	幣種	訂單計價幣種
`amount`	`number`	是	金額	訂單計價金額
`localUserRealName`	`string`	否	本地用戶真名
`sign`	`string`	是	簽章	詳情請見簽章演算法

請求 json 範例

{
 "key": "dNNTJZpgFVWlYrVv",
 "localOrderId": "conantest344",
 "localUserId": "conan",
 "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify/test",
 "isBlockchain": true,
 "channelCode":"tencentest9",
 "currency": "CNY",
 "amount": "100",
 "localUserRealName":"柯南",
 "sign": "9662c0f104123b0ccac049108f174589"
}

回應 json 範例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
           "orderId": 352950471221317,
           "localOrderId": "conantest344",
           "uiUrl": "http://im.topup.dianfus.dx.com/imserver/chat/Yy9kQ3IvVXNta3BwWE5sUzUvYVM3M2hHU0UrNjlnSzRjdVpGa1BHWmR1RUdLU0daa3pDNjZqbm1QOTRlUnRULzI5TmNyWFhjV2xJc3ZGZFVzdTFWY2tkWHF1Tk1yeUxDajFod01QRk83K2FrVnIvRm1YY0ZpUzBOK001NEZXbXhzd0ZxdzhPUVFlaGlaTCttbFdML04wb3VPZ3kvUDFkdHJISlhwVjlXVE1JPQ=="
           }
}

回應data 參數說明

參數名稱	類型	參數意義
`orderId`	`long`	訂單ID
`localOrderId`	`string`	商家平臺本地訂單號碼
`uiUrl`	`string`	付款連結位址

回呼詳情說明

**註：此類型訂單商家在處理回呼通知時，可能因我方平台延遲收到款項，導致代收訂單逾時，從而觸發訂單失敗的回調通知。當款項實際到帳後，系統會自動補發成功回呼。 ** **因此，對於此類訂單，商家只需以 status = "SUCCESS"（訂單成功）的回呼作為最終有效結果進行處理。 **

回呼的方式是：POST application/json

回呼參數 json 化範例

{
 "amount":"100",
 "currency":"CNY",
 "localOrderId":"conantest344",
 "merchantId":302992856974,
 "merchantUserId":"conan",
 "notifyTime":1757577957437,
 "orderCreateTime":1757577574425,
 "orderId":"352950471221317",
 "paidAmount":"100",
 "status":"SUCCESS",
 "type":"PAYMENT",
 "isReissue":"true",
 "sign":"774720acbacafca99af62b98d72154d3",
 "key":"9yUreYgTRtit39Dy"
}

參數名稱	類型	參與簽名	參數意義	參數說明
`amount`	`decimal`	是	訂單金額
`currency`	`string`	是	幣種
`localOrderId`	`string`	是	商家本地訂單號碼
`merchantId`	`string`	是	商家ID
`merchantUserId`	`string`	是	商家平臺本機使用者ID
`notifyTime`	`long`	是	回呼時間	毫秒
`orderCreateTime`	`long`	是	訂單建立時間	毫秒
`orderId`	`string`	是	訂單號碼
`paidAmount`	`decimal`	是	付款金額
`status`	`string`	是	訂單狀態	SUCCESS: 已完成 \| FAIL:已失敗
`type`	`string`	是	訂單類型	PAYMENT付款、WITHDRAW 提款
`isReissue`	`boolean`	是	是否補發	ture 是｜ false 否
`sign`	`string`	否	md5 簽章	詳情看簽名演算法
`key`	`string`	是	商家 key

當您收到回呼通知後，請在處理完成後直接返回字串 success，表示已成功接收並處理該訊息。系統在收到 success 回應後，將不再對該筆回呼進行重複發送。若未收到期望回應（未回傳 success 或回傳異常），系統將依照階梯式重試機制重新傳送回呼通知，最多重試 14 次。當前重試時間間隔依序為： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s

請求參數​

請求 json 範例​

回應data 參數說明​

回呼詳情說明​

回呼的方式是：POST application/json​