Skip to content

範例程式碼 ​

五種語言的完整範例,都包含:

  • 請求加密、全部 12 個介面;
  • 回調接收與核對(解密 → 核對商戶號 → 去重 → 用查詢訂單複核狀態和金額;加密貨幣充值訂單按累計入帳補差額);
  • 命令行演示;
  • 自測(不連平台,用本機模擬的平台介面);
  • 只用語言自帶的庫(Python 只多一個 cryptography),沒有其他第三方依賴。

密鑰一律從環境變數或文件讀取,範例裡沒有任何密鑰。

下載 ​

語言下載SHA256
Node.jsibitpay-openapi-nodejs.zip(13.7 KB)2e43fcd9520ee21abbe34cba10734f06b6d3f73fdfe8b9aad88b637e9193f51f
Pythonibitpay-openapi-python.zip(12.4 KB)af42ea2b8c6ea268d4c303f8c14d56a7ea3fdd48f2db193152c5c3b0720a144b
PHPibitpay-openapi-php.zip(12.5 KB)67f14d698782ee31af3e6bec9602482f8e1cdd4d8d46e488fceea4bd00c77ceb
Javaibitpay-openapi-java.zip(19.5 KB)3b06b6cf99673c8337160b0be8ca5df80d8576f30bf43840be8a965d40b01775
C#ibitpay-openapi-csharp.zip(14.7 KB)1a0387171f71a79873197b440645b2c42c9c7a69af912d0893a0c0b001151c70

下載後建議先核對 SHA256,確認文件完整、沒有被改過:

bash
# macOS / Linux
shasum -a 256 ibitpay-openapi-nodejs.zip
# Windows PowerShell
Get-FileHash ibitpay-openapi-nodejs.zip -Algorithm SHA256

全部校驗值也可以在 SHA256SUMS.txt 裡看。

執行環境 ​

語言版本說明
Node.js20 或更新沒有依賴,npm test 自測
Python3.9 或更新pip install -r requirements.txt,python -m unittest 自測
PHP8.1 或更新需要 openssl、curl 擴展,php tests/run.php 自測
Java17 或更新只用 JDK,JSON 用範例自帶的小工具,可換成 Jackson
C#.NET 8 或更新只用框架自帶的類

快速開始 ​

  1. 在商戶後台「開發者 → API 與回調」檢視介面地址、公鑰、私鑰。公鑰、私鑰各存成一個文件,放在程式碼目錄之外,只讓執行程式的帳號能讀。

  2. 設定環境變數:

    bash
    export IBITPAY_BASE_URL=商戶後台顯示的介面地址
    export IBITPAY_MERCHANT_NO=你的商戶號
    export IBITPAY_PUBLIC_KEY_FILE=/安全的目錄/ibitpay_public.pem
    export IBITPAY_PRIVATE_KEY_FILE=/安全的目錄/ibitpay_private.pem   # 只有回調服務需要
  3. 先跑自測,再跑命令行演示(如 node demo.js balance),最後按 README 接入回調服務。

每個包裡的 README 有該語言的詳細說明和出金示例。

舊版範例

以前文件裡提供的 DemoMerchant.zip 已停止維護,請改用這裡的範例。舊版回調處理沒有複核訂單,直接按回調內容入帳,存在被偽造回調的風險。