範例程式碼
五種語言的完整範例,都包含:
- 請求加密、全部 12 個介面;
- 回調接收與核對(解密 → 核對商戶號 → 去重 → 用查詢訂單複核狀態和金額);
- 命令行演示;
- 自測(不連平台,用本機模擬的平台介面);
- 只用語言自帶的庫(Python 只多一個
cryptography),沒有其他第三方依賴。
密鑰一律從環境變數或文件讀取,範例裡沒有任何密鑰。
下載
| 語言 | 下載 | SHA256 |
|---|---|---|
| Node.js | ibitpay-openapi-nodejs.zip(12.5 KB) | b11b827ea2b12bb1eb0bce39898f4e7d2184895d5e249ea8a1a72abdc9b24c59 |
| Python | ibitpay-openapi-python.zip(11.3 KB) | 19177186fd8f956bd0b7281c3a680a49789aed86a8cc6a5c186e855daa05ab91 |
| PHP | ibitpay-openapi-php.zip(11.5 KB) | 81de4476eae49a75053813571ce598f67f1b7888450a603f8cf3914f02bcc025 |
| Java | ibitpay-openapi-java.zip(18.3 KB) | 3e7a09545efa6b45fba0c79091f5797f94703095308035acbd006f0b4ee939a0 |
| C# | ibitpay-openapi-csharp.zip(13.5 KB) | b88c102b001931f0380a9ed78229f0492fbf11127cf6708cfa11bd331b9b0e3e |
下載後建議先核對 SHA256,確認文件完整、沒有被改過:
bash
# macOS / Linux
shasum -a 256 ibitpay-openapi-nodejs.zip
# Windows PowerShell
Get-FileHash ibitpay-openapi-nodejs.zip -Algorithm SHA256全部校驗值也可以在 SHA256SUMS.txt 裡看。
執行環境
| 語言 | 版本 | 說明 |
|---|---|---|
| Node.js | 20 或更新 | 沒有依賴,npm test 自測 |
| Python | 3.9 或更新 | pip install -r requirements.txt,python -m unittest 自測 |
| PHP | 8.1 或更新 | 需要 openssl、curl 擴展,php tests/run.php 自測 |
| Java | 17 或更新 | 只用 JDK,JSON 用範例自帶的小工具,可換成 Jackson |
| C# | .NET 8 或更新 | 只用框架自帶的類 |
快速開始
在商戶後台「開發者 → API 與回調」檢視介面地址、公鑰、私鑰。公鑰、私鑰各存成一個文件,放在程式碼目錄之外,只讓執行程式的帳號能讀。
設定環境變數:
bashexport IBITPAY_BASE_URL=商戶後台顯示的介面地址 export IBITPAY_MERCHANT_NO=你的商戶號 export IBITPAY_PUBLIC_KEY_FILE=/安全的目錄/ibitpay_public.pem export IBITPAY_PRIVATE_KEY_FILE=/安全的目錄/ibitpay_private.pem # 只有回調服務需要先跑自測,再跑命令行演示(如
node demo.js balance),最後按 README 接入回調服務。
每個包裡的 README 有該語言的詳細說明和出金示例。
舊版範例
以前文件裡提供的 DemoMerchant.zip 已停止維護,請改用這裡的範例。舊版回調處理沒有複核訂單,直接按回調內容入帳,存在被偽造回調的風險。