余额支付接口¶

本接口用于商户使用预存金额进行交易。

涉及到的接口包括：余额支付接口、余额支付查询接口、余额支付退款接口、余额支付退款查询接口

请求参数¶

请求地址

https://spin.cloudpnr.com/topat/acctPayment

公共请求参数

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

请求参数(data)

参数	中文名	类型	必填	最大长度	说明
req_seq_id	请求流水号	String	Y	128	请求流水号
req_date	请求时间	String	Y	8	请求时间YYYYMMDD
huifu_id	商户号	String	Y	32	商户号
out_huifu_id	出款商户号	String	Y	32	出款商户号
wallet_type	出款钱包账户类型	String	N	2	钱包余额支付时需传入（04：钱包户）
ord_amt	订单金额	String	Y	14	订单金额
good_name	商品名称	String	N	128	商品名称
good_desc	商品描述	String	N	256	商品描述
is_delay	延时标记	String	N	1	延时标记.0-非延迟；1-延迟
device_info	设备信息	String	N	1024	设备信息
mer_priv	商户私有域	String	N	1024	商户私有域
risk_check_info	风控信息	String	N	32	jsonstring，风控信息例如: “{“subProduct”:”“,”transferType”:”“}”
acct_payment_split_bunch	入账信息	JSON	Y	4000	余额支付可以支付给一个商户或者同时给多个商户，当支付给多个商户时，入账金额汇总不能超过订单金额。

入账串¶

参数	中文名	类型	必填	最大长度	说明
acct_infos	入账明细	jsonArray	Y		入账明细参见分账明细

分账明细¶

in_huifu_id	入账商户号	String	Y	16	入账方商户号
div_amt	入账金额	String	Y	12	单位元，需保留小数点后两位，例如：1.00,最低传入0.01
wallet_type	入款账户类型	String	N	2	钱包余额支付时需传入（04：钱包户）

风控信息¶

参数	中文名	类型	必填	最大长度	说明
subProduct	产品子类	String	N		产品子类
transferType	转账原因	String	Y		转账原因

响应参数¶

公共响应参数

参数	中文名	类型	必填	最大长度	说明
resp_code	网关返回码	String	Y	5	网关返回码
resp_desc	网关返回描述	String	Y	512	网关返回描述
sign	签名	String	Y		签名，对报文整体签名
data	交易响应内容体	String	N		业务返回参数

响应参数(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
huifu_id	商户号	String	Y	32
out_huifu_id	出款商户号	String	Y	32
wallet_type	出款钱包账户类型	String	N	40
hf_seq_id	汇付流水号	String	N	40
ord_amt	订单金额	String	N	14
good_name	商品名称	String	N	128	商品名称
good_desc	商品描述	String	N	256	商品描述
is_delay	延时标记	String	N	1
is_acct_div	是否分账	String	N	1
fee_flag	手续费扣款标志	String	N	1	1：外扣；2：内扣
trans_stat	交易状态	String	N	1	P：处理中；S：成功；F：失败
mer_priv	商户私有域	String	N	1024	商户私有域
acct_payment_split_bunch	入账信息	JSON	N		返回分账串

请求示例¶

{
    "data": "{\"acct_payment_split_bunch\":{\"acct_infos\":[{\"div_amt\":\"5.00\",\"in_huifu_id\":\"6666000103458877\"}],\"fee_huifu_id\":\"6666000103458831\"},\"huifu_id\":\"6666000103423237\",\"is_delay\":\"1\",\"mer_priv\":\"merPriv\",\"ord_amt\":\"5.00\",\"out_huifu_id\":\"6666000103423237\",\"req_date\":\"20210202\",\"req_seq_id\":\"4071ba55a6774b27b8c0d95d906a5c8f\",\"risk_check_info\":\"{\\\"sub_product\\\":\\\"一卡通\\\",\\\"transfer_type\\\":\\\"01\\\"}\",\"verify_type\":\"01\"}",
    "sign": "kaCA4+xhUDVloWngk61roX+HGiF0OdcvaM3CNjtL7/92ySDybJnO8zQyGYGfo1qauA4zawyMTiEvPz8bztzwOssmi/vtX7wLe3n3sIv3uJp72JIfXvIjdQWdHvC7RfB5tTsTigk3JNc94Qnm9JKB6Gi8NNrTJPOZZdwmsppGlhkA69OWSoMiiFC70Xo6gvD+58swgJgkElY7/REapXtwcFp0Zh0+zc4kKat/CMS7TddCbY/CsofkOpYF3gjg3mDw8WkB2Bd+atRLAepVhpVYHb1B9t1o+AwCKBsHcGbfES9TBIVkDf0+jrsSRwbiZw4rkbRn7+nGyQFrnLR/RKOc1w==",
    "sign_type": "RSA2",
    "sys_id": "MYPAY"
}

响应示例¶

{
    "data": "{\"acct_payment_split_bunch\":{\"acct_infos\":[{\"div_amt\":\"5.00\",\"in_huifu_id\":\"6666000103458877\",\"in_mer_id\":\"SSP001\"}],\"fee_amt\":\"0.50\",\"fee_huifu_id\":\"6666000103458831\",\"fee_mer_id\":\"SSP001\"},\"fee_flag\":\"1\",\"hf_seq_id\":\"0035default210202095957P538c6c06ebb39779\",\"huifu_id\":\"6666000103423237\",\"is_acct_div\":\"1\",\"is_delay\":\"1\",\"mer_name\":\"创造梦工厂\",\"mer_priv\":\"merPriv\",\"ord_amt\":\"5.00\",\"out_huifu_id\":\"6666000103423237\",\"req_date\":\"20210202\",\"req_seq_id\":\"4071ba55a6774b27b8c0d95d906a5c8f\",\"rtw_infos\":[],\"sub_resp_code\":\"00000000\",\"sub_resp_desc\":\"交易成功\",\"trans_stat\":\"S\",\"transfer_type\":\"ACCT_PAYMENT\",\"ts_encash_details\":[]}",
    "resp_code": "10000",
    "resp_desc": "成功调用",
    "sign": "BnN//J6ucpfyVq0qnI7mk4ZWzOopPQ1ixiB7ZyEZjBb2/Dg4lmEXJPhkqeTAT3/IFe0nvN8i3KFQH+jQ1xUM6zJtb0adluySRdcd4iO63xVQlIjYveB1SJNfIwyL+tL6fowxOhMbFC89jDGZ2iCgDpyoTXK3WCS23Jo13DRKIitW+lr6xIhjDdBTBUtgsb6fpIfcoziy8gRtR6jTswZAZ4eXkOHwJ9QyP/DHQlk86mrvAj+E0khOuMQIL2RXm2/5fCwBQdJZw/O+tRooWZN8IIoO+R+TXNRjlMYon+/uecGCfmT1xuu7JMT+gbyJvGJ/Ea5flOmDmjjQOVozbU9XgA==",
    "top_region_id": "default"
}

接口调用示例¶

Demo参考