企业账户积分充值申请¶
功能说明¶
企业积分充值申请接口
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/enterprise/account/applyCharge
- 生产环境: https://openapi.guanaitong.com/enterprise/account/applyCharge
HTTP请求方式¶
- Method: POST
- Content-Type: application/x-www-form-urlencoded
参数说明¶
-
公有参数
发送请求是必须传入公共参数,详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| account_openid | 是 | string | [32] | 积分账户的openid |
| enterprise_code | 否 | string | [1,20] | 企业编号(集团和运营商必填,企业不填) |
| amount | 是 | BigDecimal | 申请金额 | |
| service_provider | 是 | int | 企业人工充值汇款方式 1银行转账 | |
| 否 | string | 充值到账通知邮箱 | ||
| mobile | 否 | string | 充值到账通知手机号,只支持国内手机号 | |
| applicant_name | 否 | string | [1,100] | 充值申请人姓名 |
| external_code | 是 | string | [30,100] | 外部业务号,必须使用关爱通的appid开头 |
| taxpayer | 否 | string | [1,100] | 纳税人名称(抬头) |
| identifier | 否 | string | [1,45] | 纳税人识别号,纳税人名称(抬头)和纳税人识别号必填其一 |
| remark | 否 | string | [1,150] | 充值备注 |
| invoice_extr_remark | 否 | string | [1,150] | 发票补充备注信息,用户留言 |
| invoice_remark | 否 | string | [1,150] | 发票备注栏,打印在发票票面上的信息 |
请求示例¶
POST /enterprise/account/applyCharge HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=fd0082f6ebba0b5c4400e67bb6e65d68&version=1.0.0&sign=547faabbd359f9934cbb769882db6dcef12a4c1d×tamp=1655695711&account_openid=8c5a592ddb7fbd705c44a60f535b31c0&amount=100&service_provider=1&email=tomhu@guanaitong.com&applicant_name=tom&external_code=20110661_565698745564454578471&taxpayer=王纳税&remark=test
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误代码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回充值申请相关信息 |
| data.apply_charge_openid | 充值申请对应的openid |
| data.external_code | 外部业务号 |
正确返回示例¶
{
"code": 0,
"msg": "OK",
"data": {
"apply_charge_openid": "84050f07fb347bc3dcbeb48add49d99a",
"external_code": "20110661_565698745564454578471"
}
}