范例代码
五种语言的完整范例,都包含:
- 请求加密、全部 12 个接口;
- 回调接收与核对(解密 → 核对商户号 → 去重 → 用查询订单复核状态和金额;加密货币充值订单按累计入账补差额);
- 命令行演示;
- 自测(不连平台,用本机模拟的平台接口);
- 只用语言自带的库(Python 只多一个
cryptography),没有其他第三方依赖。
密钥一律从环境变量或文件读取,范例里没有任何密钥。
下载
| 语言 | 下载 | SHA256 |
|---|---|---|
| Node.js | ibitpay-openapi-nodejs.zip(13.7 KB) | 2e43fcd9520ee21abbe34cba10734f06b6d3f73fdfe8b9aad88b637e9193f51f |
| Python | ibitpay-openapi-python.zip(12.4 KB) | af42ea2b8c6ea268d4c303f8c14d56a7ea3fdd48f2db193152c5c3b0720a144b |
| PHP | ibitpay-openapi-php.zip(12.5 KB) | 67f14d698782ee31af3e6bec9602482f8e1cdd4d8d46e488fceea4bd00c77ceb |
| Java | ibitpay-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.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 已停止维护,请改用这里的范例。旧版回调处理没有复核订单,直接按回调内容入账,存在被伪造回调的风险。