金牛支付 API · 总览
本文档面向希望接入「金牛钱包」功能的开发者。通过本 API 你可以查询钱包余额、查询交易流水、创建收款订单并发起退款。 本 API 不支持第三方支付通道(支付宝/微信/银联等)的对接,仅用于金牛钱包内部的资金流转。
极简入门:阅读「鉴权方式」与「快速开始」两章即可完成首次接入。所有接口均使用 JSON 格式。
基础信息
| Base URL | https://pay.jnqj.net/api/v1 |
| 数据格式 | 请求与响应均为 application/json; charset=utf-8 |
| 字符编码 | UTF-8 |
| 时区 | Asia/Shanghai (UTC+8) |
| 金额单位 | 人民币元(CNY),保留两位小数,如 1.00 |
| 限流 | 默认 60 次/分钟(密钥创建时可配置) |
7 个端点
GET
/health
健康检查
无需鉴权
POST
/query
综合查询
scope: query
GET
/balance
钱包余额
scope: query
GET
/transactions
钱包流水
scope: query
GET
/order-lifecycle
订单生命周期
scope: query
POST
/collection
收款下单
scope: collection
POST
/refund
退款
scope: refund