查詢付款方式清單
列出貴租戶可以指派給客戶的付款方式,用於取得 POST/PUT /v1/companies 的 paymentMethods 能填的 key。不分頁——一個租戶的付款方式少且固定,建議只查一次並在你端快取。
內建的付款方式有三種:BankTransfer(匯款)、ECPayAtm(綠界 ATM 虛擬帳號)、ECPayCreditOneTime(綠界信用卡一次付清);租戶自訂的線下付款方式 key 以 Custom_ 開頭,例如 Custom_k3x9m2qa。「月結」不在清單裡,它是客戶的結帳條件,由 settlementType 決定。
清單只包含租戶已設定過的付款方式,依租戶在後台設定的順序排列。isEnabled 為 false 的付款方式仍會列出、也仍可指派給客戶,但客戶的 Specify 清單實際生效的是「清單」與「租戶目前已啟用」兩者的交集,所以這種付款方式要等租戶啟用後,採購方才看得到。內建付款方式即使不在清單裡(租戶從未設定過),寫入客戶時仍然合法,只是同樣要等租戶設定並啟用後才會生效。
Authentication
X-Signaturestring
每個 /v1 請求都必須帶 X-Client-Id、X-Timestamp、X-Nonce 與 X-Signature 四個標頭。X-Signature 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。
canonical string 的組成、可複製的簽章範例與 401 排查步驟,請參閱「驗證與簽章」。
Response
OK
data
這個租戶可以指派給客戶的完整付款方式清單,每一筆為一筆付款方式資料。
Errors
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error