取现
1. 产品介绍
1.1 简介
商户主动发起将收款资金取现到绑定的银行卡;
- 商户开通结算的前提:渠道商端已开通取现相关权限,渠道商端权限开通仅支持在运营控台开通
- 取现配置:支持配置D0(取现当日到账)、D1(取现次日到账)、T1(取现次工作日到账)
1.2 应用场景
- 取现适用于商户、用户手动发起将收款资金转入指定的银行卡;
2. 接入前准备
2.1 商务准备
取现-控台配置操作指引
商户准入取现配置:服务商控台-【商户管理】-【商户入驻】-【新增】-【业务信息】-【增值服务】-【取现配置】
- 取现业务类型:支持D0、D1和T1部分及全部勾选
- 配置D0、D1、T1取现手续费及取现手续费率
- 开通时配置取现手续费只支持统一选择内扣或外扣,变更时,支持单个取现类型分别设置内扣或外扣
- 取现手续费=手续费固定金额+取现费率%*取现金额
操作取现
取现接口开发者站点链接:https://paas.huifu.com/partners/api/#/jyjs/qx/api_qx
接口取现目前仅支持基本户提现
控台端提现路径:商户控台-【账户管理】
2.2 对接准备
第一步:密钥获取
联调之前需要先获取公私钥,参见公私解钥参数获取说明;
第二步:公共参数获取
登录服务商/商户控台后,可在开发设置-开发者信息中,获取sys_id,product_id参数信息;(如控台未展示,请联系对接群内汇付技术助手提供)
3. 开发指引
3.1 对接规范
调用汇付接口,均采取POST形式提交,数据格式统一为JSON格式,相关SDK及签名方法见链接:
SDK示例:Java SDK
加签验签:v2版接口加签验签
3.2 系统接口
3.2.1 开通配置类
以下接口涉及取现的配置:企业商户基本信息入驻、个人商户基本信息入驻、商户基本信息修改;
入参需关注以下域字段:
参数 | 中文名 | 说明 |
---|---|---|
card_info | 结算卡信息配置 | 商户结算银行账户信息配置,jsonObject格式 |
cash_config | 取现信息配置 | 商户取现信息配置,jsonArray格式 |
返参需关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
token_no | 绑卡序列号 | 绑定结算银行账户的ID号,审核通过后返回 |
3.2.2 取现操作
入参关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
huifu_id | 取现方ID号 | 提现发起方的汇付ID。支持已配置取现规则的商户、用户。 |
acct_id | 账户号 | 可指定账户号,仅支持基本户、现金户 |
cash_amt | 取现金额 | 单位元 |
into_acct_date_type | 到账日期类型 | D0:当日到账;当日交易资金当天可取现到账; T1:次工作日到账; D1:次自然日到账; DM:当日到账;到账资金不包括当天的交易资金; |
token_no | 取现卡序列号 | 绑定取现卡后可获取取现卡序列号 |
4. API列表
类型 | 功能 | 描述 |
---|---|---|
应用程序接口 | 企业商户基本信息入驻 | 配置取现规则及结算卡 |
应用程序接口 | 个人商户基本信息入驻 | 配置取现规则及结算卡 |
应用程序接口 | 商户基本信息修改 | 修改取现配置及结算卡 |
应用程序接口 | 商户详细信息查询 | 查询取现配置及结算卡 |
应用程序接口 | 取现接口 | 取现操作 |
应用程序接口 | 出金交易查询接口 | 取现交易查询 |
应用程序接口 | DM取现额度查询 | 查询DM取现额度 |