wsmwason/taiwan-bank-code

Taiwan Bank Code List

taiwan-bank-code 台灣銀行代碼清單

主要用途

提供台灣的銀行代碼清單 JSON 格式，資料來源為 財金資訊股份有限公司 的 開放資料 XML 檔案， 透過 PHP 將 XML 轉換為 JSON 格式方便運用。, _(*1)

關於此程式

雖然 財金資訊股份有限公司 的 開放資料 有提供完整的 XML 或 CSV 格式的清單， 但其實內容包含了各種不同類型的銀行代碼清單：, _(*2)

• 全國性繳費/稅業務-活期性帳戶繳費作業
• 外幣結算平台-美元
• 通匯業務-證券匯款
• 通匯業務-公庫匯款
• ...

一般情況下我們只會需要 網路ATM、通匯業務-入戶電匯 或 跨行自動化服務機器業務(金融卡) 的類型即可， 因此此程式下載 XML 後只會將這幾個類型的清單處理為 JSON 格式的檔案。, _(*3)

安裝

透過 Composer 安裝, _(*4)

composer require wsmwason/taiwan-bank-code

簡易使用方式

取得 網路ATM 銀行代碼清單, _(*5)

$taiwanBankCode = new wsmwason\TaiwanBankCode();
$bankCodeList = $taiwanBankCode->listBankCodeATM();

取得 通匯業務-入戶電匯 銀行代碼清單, _(*6)

$taiwanBankCode = new wsmwason\TaiwanBankCode();
$bankCodeList = $taiwanBankCode->listBankCodeTT();

取得 跨行自動化服務機器業務(金融卡) 銀行代碼清單, _(*7)

$taiwanBankCode = new wsmwason\TaiwanBankCode();
$bankCodeList = $taiwanBankCode->listBankCodeCrossATM();

只要 data/ 目錄內含有 JSON 檔案， 就能透過 listBankCodeATM() 或 listBankCodeTT() 取得銀行代碼清單。, _(*8)

可取得 ATM 的 Array：, _(*9)

Array
(
    [0] => Array
        (
            [code] => 004
            [name] => 臺灣銀行
        )

    [1] => Array
        (
            [code] => 005
            [name] => 臺灣土地銀行
        )
    ...
)

或是自己把 data/ 目錄的 JSON 直接讀取來用。, _(*10)

更新來源

本來是不想把 XML 放在專案內， 不過台灣的銀行代碼異動應該不算是太頻繁， 如果有更新時之後會再發布新版來更新 JSON 內容。, _(*11)

不過如果真的想直接更新的話，還是可以用 TaiwanBankCodeDataUpdate 來下載 XML 以及轉換 JSON 格式檔案， 如果真的有更新可以順手發個 PR 發布新版。, _(*12)

執行下載 XML 及轉換 JSON, _(*13)

$taiwanBankCodeDataUpdate = new wsmwason\TaiwanBankCodeDataUpdate();

// Download XML
$taiwanBankCodeDataUpdate->updateXmlFromFisc();

// Convert to Json
$taiwanBankCodeDataUpdate->convertJsonFromXml();

版本紀錄

1.0.0 正式釋出, _(*14)

License

The MIT License (MIT), _(*15)