查詢收款方式

查詢你已開通的法幣，以及每個法幣出款時支援的收款方式和要填的資訊。建立出金訂單前用它確定 paymentMethod 和要傳的欄位。

POST/api/open/order/getPaymentMethods

完整地址 = 介面地址 + 這個路徑。介面地址在商戶後台「開發者 → API 與回調」檢視。

請求參數

參數	類型	必填	說明
merchantNo	string	是	商戶號
currencyType	string	否	只查這一個法幣；不傳回傳全部已開通的法幣

回傳

欄位	類型	說明
currencies[].currency	string	法幣程式碼
currencies[].symbol	string	貨幣符號
currencies[].decimals	int	金額小數位
currencies[].methods[].paymentMethod	int	收款方式編號，出金時傳給 paymentMethod
currencies[].methods[].name	string	收款方式名稱（英文）
currencies[].methods[].kind	string	類型：bank 銀行轉帳、wallet 電子錢包、qrcode 掃碼
currencies[].methods[].fields[]	array	要填的資訊
fields[].key	string	欄位標識
fields[].apiParam	string	對應建立出金訂單的參數名；為空表示這項不能通過介面傳
fields[].label	string	欄位名稱（英文）
fields[].required	bool	是否必填
fields[].pattern	string	格式要求（正則表達式），為空表示不限
fields[].hint	string	填寫提示
currencies[].methods[].banks[]	array	可選的銀行（name、code），有的話 bankName 請從中選

{
  "code": 0,
  "message": "success",
  "data": {
    "currencies": [
      {
        "currency": "THB",
        "symbol": "฿",
        "decimals": 2,
        "methods": [
          {
            "paymentMethod": 1,
            "name": "Bank transfer",
            "kind": "bank",
            "fields": [
              { "key": "owner", "apiParam": "bankAccountName", "label": "Account name", "required": true, "pattern": "", "hint": "" },
              { "key": "account", "apiParam": "bankAccountNumber", "label": "Account number", "required": true, "pattern": "^[0-9]{10,12}$", "hint": "" }
            ],
            "banks": [ { "name": "Kasikornbank", "code": "KBANK" } ]
          }
        ]
      }
    ]
  }
}

上面只是格式示例，實際的收款方式、欄位和銀行以介面回傳為準。

常見錯誤

40010、40017。