代发¶

本API为后台版接口，用于商户从汇付账户代发到银行账户中。

请求参数¶

请求地址

环境	HTTPS请求地址	请求方法
测试环境	https://spin-test.cloudpnr.com/toppas	/surrogate
生产环境	https://spin.cloudpnr.com/toppas	/surrogate

公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」，请求报文体BODY - 「接口规则-参数规定-报文体」，响应报文体 - 「接口规则-参数规定-响应报文体」

请求参数(data)

参数	中文名	类型	必填	最大长度	说明
req_seq_id	请求流水号	String	Y	128	请求流水号
req_date	请求时间	String	Y	8	请求时间
mer_ord_id	商户订单号	String	Y	50	商户订单号
huifu_id	商户号	String	Y	32
cash_amt	代发金额.单位:元	String	Y	14	代发金额
into_acct_date_type	到账日期类型	String	Y	3	T0-T0交易；T1-T1交易；D1-D1交易；
notify_url	异步通知地址	String	Y	512	virgo://#{http_server_url} 例：virgo://http://www.xxx.com/getResp
purpose	代发用途	String	Y	255	代发用途
bank_account_crypt	银行账号密文	String	Y	64	银行账号密文,银行账号使用公钥做加密
bank_code	银行编号	String	Y	8	银行编号
bank_account_name	银行卡用户名	String	Y	60	银行卡用户名
public_and_private_flag	对公对私标识	String	Y	2	对公对私标识：01-对公，02-对私
province	省份	String	Y	4	省份
area	地区	String	Y	4	地区
subbranch_bank_name	支行名	String	N	60	支行名
correspondent_code	联行号	String	N	30	联行号
phone_number_crypt	手机号密文	String	N	64	手机号密文,手机号使用公钥做加密
certify_type	证件类型	String	N	2	证件类型
certify_no_crypt	证件号密文	String	N	64	证件号密文,证件号使用公钥做加密
bank_acct_three_in_one	收款方三证合一码	String	Y	50	对公代发必填，无三合一码时，填营业执照号
risk_check_info	风控信息	String	N	1024	风控信息，jsonstring

风控信息¶

参数	中文名	类型	必填
longitude	经度	String	Y
latitude	纬度	String	Y
base_station	基站地址	String	Y

响应参数¶

同步响应参数(data)

参数	中文名	类型	必填	最大长度	说明
sub_resp_code	业务返回码	String	Y	8	业务返回码
sub_resp_desc	业务返回描述	String	Y	512	业务返回描述
req_seq_id	业务请求流水号	String	Y	128	请求流水号
req_date	业务请求时间	String	Y	8	YYYYMMDD
mer_ord_id	商户订单号	String	N	32
hf_seq_id	汇付流水号	String	N	128
trans_status	交易状态	String	N	1	S：成功；F：失败；P：处理中
acct_status	账务状态	String	N	1	S：成功；F：失败；P：处理中

异步响应参数(resp_data)

参数	中文名	类型	必填	最大长度	说明
sub_resp_code	业务返回码	String	Y	8	业务返回码
sub_resp_desc	业务返回描述	String	Y	512	业务返回描述
req_seq_id	业务请求流水号	String	Y	128	请求流水号
req_date	业务请求时间	String	Y	8	YYYYMMDD
mer_ord_id	商户订单号	String	N	32	商户订单号
hf_seq_id	汇付流水号	String	N	128
msg_type	消息类型	String	N	2	01：通道；02：账务
trans_status	交易状态	String	N	1	S：成功；F：失败；P：处理中
trans_type	交易类型	String	N	16	S：成功；F：失败；P：处理中
channel_status	通道状态	String	N	1	S：成功；F：失败；P：处理中
acct_status	账务状态	String	N	1	S：成功；F：失败；P：处理中

请求示例¶

{
    "data": "{\"sys_id\":\"TEST\",\"req_seq_id\":\"2726351820169648\",\"req_date\":\"20200415\",\"mer_ord_id\":\"2726351820169648\",\"huifu_id\":\"6666000003087743\",\"fee_huifu_id\":\"6666000003087743\",\"cash_amt\":\"10.00\",\"fee_amt\":\"2.00\",\"fee_rec_type\":\"1\",\"into_acct_date_type\":\"T0\",\"notify_url\":\"virgo://http://www.gangcai.com\",\"token_no\":\"10000091288\",\"fee_flag\":\"2\"}",
    "sign": "mCLKrL0RP/44AbOto6d7onpAOUBbVoBD30lNqHQ0tdYC9NVCBwFMqQNN1pslzb0I0G02D0WuVxT3PlST7YxEOv0YXN7t8cIiik+oMy+W2Ca3N8zea+1sklfXNg8E1QzwKu3MuawnO+lwtEnMCSirryhV/+YEimpiw+I/3qMj1eBg4jt5eYqVv3IrCDIBBUMx1OxM+ATGFd1gmqORMWpP373XLZJeQI/icufgBcdOgz/aI6YG91OaccBU8jFpo6TIbJB4Ak7oVdKtp+jW27bi3EG7ir6Z9A0JxGONwddNuRwETaP7wL1QLtf1i+VC+r5NurEnJ95Pwu4l6+EELoYlfQ==",
    "sign_type": "RSA2",
    "sys_id": "TEST"
}

响应示例¶

{
    "data": "{\"acct_status\":\"P\",\"cash_amt\":\"10.00\",\"fee_amt\":\"2.00\",\"hf_seq_id\":\"00300000000200420175507P167c0a8559500000\",\"mer_ord_id\":\"2726351820169648\",\"req_date\":\"20200415\",\"req_seq_id\":\"2726351820169648\",\"sub_resp_code\":\"00000000\",\"sub_resp_desc\":\"成功\",\"top_region_id\":\"top_A\",\"trans_status\":\"P\"}",
    "resp_code": "10000",
    "resp_desc": "成功调用",
    "sign": "aszLb1ySJmRpbqg4Z3zyv+f0vHQii6bPoJTruCbxE108QY1mSy29L7eC33gVuvxWNuD82Sz2fHsKrGUCh3ZFJMs5k8N66JyePtQfonh8gsu/vFNiEvyV3SvfgFCpfq/3DSYBgepgXjmfAI/gVG13XB5nkZVg/mVNAXKMf9WDsomcrmnvMVaKGYqPXUEzC6wATRy6wq342HE2fexYspIwYYpCHwSI8cSexRbOexT97jJirZWzSrqRD3Yt4BfUCuFBvJLpqITJprZx6HBBFV08Ooe0pI481N1KSyWBAh0tPt8U7rdYnkRE9e2LlUzXriJEnNYtqJLwq9HQIxxvLWsjMA=="
}

接口调用示例¶

Demo参考