API 接口
本页说明仁刚发面向合作方开放的接口能力。接口仅对签署合作协议的合作方开通，不对外公开调用。
一、能力范围
| 能力 | 说明 |
|---|---|
| 卡种与报价查询 | 按品类或卡种查询当前是否在收、报价区间与面额限制 |
| 订单提交 | 提交卡号、卡密、面额，返回订单号与验卡状态 |
| 订单状态查询 | 按订单号查询验卡结果、结算金额与失败原因 |
| 结算对账 | 按日期区间拉取结算明细，用于对账 |
二、接入流程
1. 商务对接并签署合作协议；
2. 提供服务器出口 IP，平台加入白名单；
3. 分配调用凭证（密钥），约定调用频率上限；
4. 在测试环境联调通过后切换生产环境。
三、调用约定
- 所有请求须使用 HTTPS，并在请求头携带凭证；
- 请求与响应均为 JSON，字符编码 UTF-8；
- 超出约定频率的请求会被限流，返回限流错误码；
- 卡密等敏感字段在日志中脱敏存储，合作方不得留存明文卡密。
四、合规要求
- 合作方不得转售接口能力，不得将接口用于未约定用途；
- 合作方须保证通过接口提交的卡券来源合法；
- 因合作方违规使用导致的损失与法律责任，由合作方承担。
接口文档、字段定义与错误码在签署协议后由对接人提供。咨询：13986558049（08:00-23:00）。