跳至主要内容

轉帳

處理會員的存款或提款交易。

API 信息​

  • 端點：POST /v2/members/transaction
  • 認證：Bearer Token
  • 加密：請求使用 AES-256-GCM 加密，響應為明文 JSON

請求​

請求標頭​

POST /v2/members/transaction HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 56ffd5ecd8a3a4457863a0bd7c298fb2
x-signature: 904e97bee2589b93e9747eed0346c68b23d8ff8b568dabaf4b94a5e89093df67

請求參數​

加密前的參數​

{
  "username": "testacoount001",
  "amount": 10,
  "transId": "2c205e4f-c922-4967-8e45-f14480a2f075"
}

加密後的請求體​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
欄位類型必填說明
usernamestring是會員帳號
transIdstring是交易 ID（平台端端唯一標識符）
amountnumber是交易金額，正數為存款，負數為提款

響應​

成功響應​

{
  "code": 0,
  "message": "No error.",
  "data": {
      "amount": 10,
      "balance": 2323.582,
  },
  "logUUID": "fff937f4-b436-496e-baeb-6dfaa4743e43"
}

響應欄位說明​

欄位類型說明
data.amountnumber交易金額
data.balancenumber交易後餘額

錯誤響應​

{
  "code": 3,
  "message": "The transaction already exist.",
  "logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}

常見錯誤碼​

狀態碼說明
2餘額不足
3交易已存在
8會員不存在
11參數錯誤
19帳號無效
20會員錢包暫時鎖定
35交易處理中
83認證失敗
84解密失敗

更多錯誤碼說明請參考：附錄 - 錯誤碼總覽

注意事項​

  1. 交易 ID 唯一性：每個 transId 在同一 agentId 下必須唯一，用於防止重複交易
  2. 金額精度：金額保留 2 位小數
  3. 幣別一致性：交易幣別必須與會員創建時的幣別一致
  4. 餘額檢查：提款時會檢查餘額是否充足
  5. 冪等性：使用相同的 transId 不會重複執行

相關 API​