申请银行转账充值

更新时间：2024.09.24

商户系统须通过调用此接口获取银行转账账号，随后发起充值流程

接口说明

支持商户：【普通商户】

请求方式：【POST】/v3/recharge/bank-transfer-recharges/apply

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 必填 string

请参考签名认证生成认证信息

Accept 必填 string

请设置为 application/json

Content-Type 必填 string

请设置为 application/json

Body 包体参数

out_recharge_no 必填 string(64)

【商户充值单号】商户系统内部的充值单号，只能由数字、大小写字母组成，在平台商户系统内部唯一

recharge_scene 必填 string

【充值场景】仅支持银行转账充值。可选取值：

NORMAL_BANK_TRANSFER: 银行转账充值

account_type 必填 string

【充值入账账户】充值入账账户资金。可选取值：

BASIC: 基本户
OPERATION: 运营户
FEES: 手续费账户

recharge_amount 必填 object

【充值金额】单位为分，仅支持CNY。单次充值上限为2千万

属性

amount 选填 int

【总金额】单位为分

currency 选填 string(16)

【货币类型】人民币为CNY

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/recharge/bank-transfer-recharges/apply \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7  "account_type": "BASIC",
8  "out_recharge_no": "cz202407181234",
9  "recharge_amount": {
10    "amount": 500000,
11    "currency": "CNY"
12  },
13  "recharge_scene": "NORMAL_BANK_TRANSFER"
14 }'

返回参数

200 OK

recharge_id 必填 string(27)

【微信支付充值单号】微信支付充值单号

out_recharge_no 必填 string(64)

【商户充值单号】商户系统内部的充值单号，只能由数字、大小写字母组成，在平台商户系统内部唯一

transfer_in_account 必填 object

【银行账户】充值目标账户

属性

bank_name 选填 string(16)

【开户银行名称】开户银行名称

bank_address_code 选填 string(16)

【开户银行省市编码】开户银行省市编码，详细参见《省市区编码对照表》

bank_code 选填 string(16)

【开户银行行号】开户银行行号

bank_account_name 选填 string(32)

【银行账户名称】银行账户名称

bank_account_no 选填 string(32)

【银行账号】银行账号

返回示例

200 OK

1{
2  "out_recharge_no": "cz202407181234",
3  "recharge_id": "172207846292553701",
4  "transfer_in_account": {
5    "bank_account_name": "某某某有限公司",
6    "bank_account_no": "686000172489957748585801",
7    "bank_address_code": "440300",
8    "bank_code": "991584000049",
9    "bank_name": "财付通-备付金账户"
10  }
11}

错误码

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	请根据错误提示处理
400	PARAM_ERROR	参数格式校验失败	请根据错误提示正确传入参数
400	PARAM_ERROR	超过充值单单笔上限	请降低充值金额重试
403	NO_AUTH	商户无权限	请联系对接的运营人员申请权限
429	FREQUENCY_LIMITED	频率超限	该笔请求未处理，请降低频率后使用相同的参数再重试
500	SYSTEM_ERROR	系统错误	请使用相同参数稍后重试

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服