申请固定二维码
接口说明
申请固定二维码接口用于为已入驻的商户生成固定的收款二维码。支持设置二维码类型和是否开启自定义参数功能。
请求地址
【POST】/pay/applyment/qrcode_apply
业务参数
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| merchant_no | 是 | String(32) | 商户号（审核通过后获取） | 1234567890 |
| title | 是 | String(64) | 终端名称/收款二维码标题（用于显示在收款页面） | 张三便利店 |
| enable_custom_form | 是 | Boolean | 是否启用自定义表单true 启用false 不启用 | true |
| form_id | 条件 | String(32) | 表单定义ID，当 enable_custom_form 为 true 时必填（通过创建自定义表单接口获取） | FORM_20231201103000001 |
请求示例
示例1：启用自定义表单
{
"merchant_no": "1234567890",
"title": "张三便利店",
"enable_custom_form": true,
"form_id": "FORM_20231201103000001"
}
示例2：不启用自定义表单
{
"merchant_no": "1234567890",
"title": "李四水果店",
"enable_custom_form": false
}
返回结果
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| code | 是 | String(32) | 返回码,000000 表示成功 | 000000 |
| message | 是 | String(128) | 返回信息 | 申请成功 |
| terminal_no | 是 | String(32) | 终端编号（后端系统生成，二维码统一纳入终端管理） | T_20231201103000001 |
| qrcode_url | 是 | String(256) | 二维码内容链接（用于生成二维码） | https://pay.fuiouyes.com/pay/QR_20231201103000001 |
| qrcode_pic | 是 | String | 二维码图片（Base64 编码的 PNG 图片） | iVBORw0KGgoAAAANSUhEUgAA... |
| title | 是 | String(64) | 终端名称/收款二维码标题 | 张三便利店 |
| enable_custom_form | 是 | Boolean | 是否启用自定义表单true 启用false 不启用 | true |
返回示例
示例1：启用自定义表单
{
"code": "000000",
"message": "申请成功",
"terminal_no": "T_20231201103000001",
"qrcode_url": "https://pay.fuiouyes.com/pay/QR_20231201103000001",
"qrcode_pic": "iVBORw0KGgoAAAANSUhEUgAA...",
"title": "张三便利店",
"enable_custom_form": true
}
示例2：不启用自定义表单
{
"code": "000000",
"message": "申请成功",
"terminal_no": "T_20231201103000002",
"qrcode_url": "https://pay.fuiouyes.com/pay/QR_20231201103000002",
"qrcode_pic": "iVBORw0KGgoAAAANSUhEUgAA...",
"title": "李四水果店",
"enable_custom_form": false
}
DATE 日期选择器 日期选择（年-月-日） 自动校验日期格式 YYYY-MM-DD
错误码
| 错误码 | 说明 |
|---|---|
| 000000 | 成功 |
| FAIL | 失败 |
| PARAM_ERROR | 参数错误 |
| MERCHANT_NOT_FOUND | 商户号不存在 |
| MERCHANT_NOT_APPROVED | 商户未审核通过 |
| QRCODE_APPLY_LIMIT_EXCEEDED | 二维码申请数量超限 |
| FORM_ID_NOT_FOUND | 表单定义不存在 |
注意事项
- 商户必须已通过进件审核（状态为 APPROVED）才能申请固定二维码
- 每个商户最多可申请 10 个固定二维码（终端）
- title 字段为终端名称/收款二维码标题，会显示在用户扫码后的收款页面顶部
- 启用自定义表单时，需先通过「创建自定义表单定义」接口创建表单，获取 form_id 后传入
- 同一套表单定义可被多个二维码终端复用，避免数据冗余
- 二维码统一纳入终端管理，返回的 terminal_no 为终端编号，用于后续的终端管理和交易查询
- 用户扫码时可填写自定义表单中定义的字段信息（如姓名、手机号、收货地址等），便于后续对账和业务处理
- 二维码生成后请及时下载保存，链接有效期为 30 天
- 用户提交的表单数据将在支付通知接口中返回，详见支付通知文档