5.2.1 建立提款至VAPY錢包訂單

#簡要描述： 將人民幣或數位幣提現到錢包的提現業務接口，讓用戶能夠將帳戶餘額轉移到指定的錢包地址

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

請求參數

參數名稱	類型	必填	參數意義	參數說明
key	string	是	商家 key	apiKey
localOrderId	string	是	商家平臺本地訂單號碼	商家平臺本地產生唯一訂單號碼
localUserId	string	否	商家平臺本機使用者ID	商家平臺本機使用者ID
amount	number	是	訂單金額	提款金額
email	string	否	提現信箱	使用者信箱(與使用者 ID2 選 1)
userId	string	否	使用者 id	使用者信箱(與使用者 ID2 選 1)
notifyUrl	string	否	回呼位址	下單成功後，由 API 回呼通知商家的位址（回調詳情參考文件3）
currency	string	是	支援幣種	幣種(錢包支援幣種)
successRedirectUrl	string	否	位址	成功後自動跳轉位址
expireSecond	Long	否	過期時間戳記（秒）
sign	string	是	簽章	詳情請見簽章演算法

請求 json 範例

{
  "key": "08SaKUwNafSOc8w7",
  "localOrderId": "2023102400684344447",
  "localUserId": "302199873005",
  "email": "diamond8888@gmail.com",
  "amount": "100",
  "currency": "CNY",
  "successRedirectUrl": "WWW.BAIDU.COM",
  "notifyUrl": "www.baidu.com/notify/callback",
  "sign": "41c48ea2951934626b4435f02aecf732"
}

回應 json 範例

{
  "code": 0,
  "success": true,
  "message": "string",
  "data": {
    "orderId": "2023102400684344447",
    "localOrderId": "2023102400684344447",
    "localUserId": "302199873005",
    "withdrawBizType": "WITHDRAW_WALLET",
    "orderType": "PAYMENT",
    "toUserId": 4603
  }
}

回應data 參數說明

參數名稱	類型	參數意義	備註
orderId	string	訂單 ID
localUserId	string	商家本地用戶 ID
localOrderId	string	商家本地訂單號碼
orderType	enum	訂單類型	PAYMENT：支付订单WITHDRAW：提款订单
orderBizType	enum	訂單業務類型	orderBizType 類型說明如下
toUserId	number	收款用戶ID	VAPY錢包用戶ID

orderBizType 類型說明：

1、PAYMENT_WALLET_SCAN VAPY錢包掃碼支付 2、PAYMENT_TRANSFER 數位幣綁定地址直充 3、PAYMENT_ANY_DIGITAL_SCAN 數位幣任意金額掃碼支付 4、WITHDRAW_WALLET 提款至VAPY錢包 5.WITHDRAW_ANY_DIGITAL_WALLET 提款數位幣至任意錢包 6、PAYMENT_FIXED_DIGITAL_SCAN 數位幣限定金額掃碼支付 7、BATCH_PAY 大量代付

回呼返回 json 資料

預設所有回呼參數參與驗簽，回呼參數詳情請看回呼

回呼 data

{
"amount":"4",
"bizType":"WITHDRAW_WALLET",
"currency":"USDT",
"localOrderId":"conan41123",
"merchantActualAmount":"31.45",
"merchantCurrency":"USDT",
"merchantId":302992856974,
"merchantPaidAmount":"4",
"merchantUserId":"conan",
"notifyTime":1772364467800,
"orderCreateTime":1772364292167,
"orderId":"474083263103237",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"28.37",
"userCurrency":"USDT",
"userReceivableAmount":"28.37",
"walletUserId":4603,
"sign":"bc92191367449df36920178e05731a6b",
"key":"9yUreYgTRtit39Dy"
}

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