Skip to content

范例代码 ​

五种语言的完整范例,都包含:

  • 请求加密、全部 12 个接口;
  • 回调接收与核对(解密 → 核对商户号 → 去重 → 用查询订单复核状态和金额);
  • 命令行演示;
  • 自测(不连平台,用本机模拟的平台接口);
  • 只用语言自带的库(Python 只多一个 cryptography),没有其他第三方依赖。

密钥一律从环境变量或文件读取,范例里没有任何密钥。

下载 ​

语言下载SHA256
Node.jsibitpay-openapi-nodejs.zip(12.5 KB)b11b827ea2b12bb1eb0bce39898f4e7d2184895d5e249ea8a1a72abdc9b24c59
Pythonibitpay-openapi-python.zip(11.3 KB)19177186fd8f956bd0b7281c3a680a49789aed86a8cc6a5c186e855daa05ab91
PHPibitpay-openapi-php.zip(11.5 KB)81de4476eae49a75053813571ce598f67f1b7888450a603f8cf3914f02bcc025
Javaibitpay-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.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 已停止维护,请改用这里的范例。旧版回调处理没有复核订单,直接按回调内容入账,存在被伪造回调的风险。