CLI 工具
一行命令完成收款、查单、退款。适合 CI/CD 流水线、定时对账脚本、自动化运维。
输出标准 JSON，可直接 pipe 给 jq 处理。
安装与配置
1
创建配置文件
在用户目录下创建 ~/.jnqj-pay.json：
{
"base_url": "https://pay.jnqj.net",
"key_id": "jk_xxxxxxxxxxxxxxxx",
"key_secret": "sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"merchant_id": 1
}
也可使用环境变量：JNQJ_BASE_URL / JNQJ_KEY_ID / JNQJ_KEY_SECRET / JNQJ_MERCHANT_ID（优先级高于配置文件）
命令列表
| 命令 | 说明 | 示例 |
|---|---|---|
health |
健康检查（无需认证） | php jnqj-pay health |
balance |
查询钱包余额 | php jnqj-pay balance |
collect <amount> |
创建收款订单 | php jnqj-pay collect 29.90 --title="VIP月卡" |
query <tx_no> |
查询订单状态 | php jnqj-pay query T20260729... |
lifecycle <tx_no> |
查询订单全生命周期 | php jnqj-pay lifecycle T20260729... |
refund <tx_no> |
发起退款 | php jnqj-pay refund T20260729... --reason="退款" |
transactions |
查询交易流水 | php jnqj-pay transactions --type=collection --direction=in |
实战示例
创建收款并获取支付链接：
$ php jnqj-pay collect 29.90 --title="VIP会员月卡"
{
"ok": true,
"data": {
"tx_no": "T202607291200001234ABCD",
"pay_url": "https://pay.jnqj.net/pay/T202607291200001234ABCD",
"amount": 29.90,
"expire_seconds": 1800
}
}
配合 jq 提取支付链接：
$ php jnqj-pay collect 99.00 --title="年度会员" | jq -r '.data.pay_url'
https://pay.jnqj.net/pay/T202607291200005678EFGH
CI/CD 自动对账脚本示例：
#!/bin/bash
# 每日自动对账脚本
DATE=$(date +%Y-%m-%d)
echo "=== $DATE 对账报告 ==="
# 查询余额
echo "[余额]"
php jnqj-pay balance | jq '.data.merchant.balance'
# 查询当日收款流水
echo "[收款流水]"
php jnqj-pay transactions --type=collection --direction=in \
--from=$DATE --to=$DATE | jq '.data[] | {tx_no, amount, created_at}'
提示：CLI 工具源码位于
bin/jnqj-pay，无需安装依赖，仅需 PHP 8.0+ 和 cURL 扩展。