1. 协议规则

1.1接入方对接API须遵循以下规则：

传输方式：HTTPS

提交方式：采用POST方式提交

数据格式：JSON

字符编码：统一采用UTF-8字符编码

签名算法：RSA2

所有图片地址都必须是https协议开头

2. 公共参数

2.1 通用报文格式

【公共请求参数】

M必填 O选填 C条件必填

参数名称	参数含义	是否必须	数据类型	备注
appId	应用APPID	M	string	商户应用APPID，为汇联商户控台中的应用APPID，非微信公众号与小程序的APPID
requestId	请求ID	M	string	请求唯一标识，无其他意义，必须每一次请求不允许重复，用于定位问题
signType	签名方式	M	string	固定值：RSA2
timestamp	请求时间戳	M	integer(int64)	毫秒，13位
version	版本号	M	string	固定值：1.0
charset	字符编码	M	string	固定值：UTF-8
subSn	子商户号	C	string	非必传项，普通商户可忽略，平台商户以及代理商可传
sign	签名串	M	string	参照签名方法
bizContent	业务请求参数体	M	string	业务请求参数，JSON 格式字符串

【公共返回参数】

参数名称	参数含义	是否必须	数据类型	备注
code	响应状态	M	integer	响应状态，非200时为网关层，鉴权效验服务层拦截，将不会入库，非200时只会返回code，msg两个参数
msg	响应说明	M	string
appId	应用APPID	O	string	固定值：RSA2
signType	签名方式：RSA2	O	String	固定值：RSA2
timestamp	响应时间戳	O	string	单位毫秒
sign	签名串	O	string	签名值
data	响应业务数据	O	string	业务响应参数，JSON 格式字符串

2.2 报文示例

【请求报文】

{"appId":"APP_01863208408","timestamp":1763041713870,"requestId":"e34ec4043d4c3a3a16c0d8d533431d3b","version":"1.0","signType":"RSA2","charset":"UTF-8","bizContent":"{\"account_book_id\":\"2088970907720362\",\"mch_order_no\":\"fdb9d43464353242343315\",\"trans_amount\":\"0.1\",\"product_code\":\"AQF-TRANSFER-BANKCARD\",\"order_title\":\"踢脚线驳船哼尽管关于\",\"notify_url\":\"https://api.3ypay.com/pay-service/openapi/order/notify\",\"payee_info\":{\"identity_type\":\"ALIPAY_LOGON_ID\",\"name\":\"张三\",\"identity\":\"95\",\"bankcard_ext_info\":{\"account_type\":\"1\",\"inst_name\":\"招商银行\"}},\"remark\":\"veniam fugiat sunt\",\"business_params\":{\"payer_show_name_use_alias\":false,\"withdraw_timeliness\":\"T0\",\"payer_show_name\":\"湛奕辰\"}}","sign":"VfeYUX28nn/9ZOBEpezfpmb3194jtWr2Ohh2BrRj3DzivljdPdWTkQLyN4aefAq6sUzswXEZgnKwwBmYzQr0omGo7zdJ3GSr/5T9c/X1jvjHbDzIyXNyJmLj9w8yRhAoK6pIwD6+znBdk9sIQmYwhYKrDkPsMxxTN/JBBA9xnJPQmTBEiO2t0i0Q0fpbSP755ZMt6m9gfXw9KBr7mIq/OIE5Y2LfWiqY5hMGfpF0GJKV/v9pf6cVkaJbMif6MnBiiWQhUd9Rp2AlUvlOGx94Yhnhd2QF5CDkXKfdPYvVA+v3SPUArscw+oggIPyF2jPNyOYlw1dXBnLwkVA+E6YQqw=="}

【响应报文】

{
    "appId": "APP_01863208408",
    "code": 200,
    "data": "{\"order_title\":\"踢脚线驳船哼尽管关于\",\"batch_no\":\"\",\"account_book_id\":\"2088970907720362\",\"bill_file_id\":\"\",\"bill_error_message\":\"\",\"remark\":\"veniam fugiat sunt\",\"out_biz_no\":\"N202511101459127284\",\"trans_amount\":\"0.10\",\"product_code\":\"AQF-TRANSFER-BANKCARD\",\"bill_download_url\":\"\",\"fee_rate\":\"[{\\\"rateType\\\":\\\"SINGLE_PERCENT\\\",\\\"percentRate\\\":1}]\",\"fee_amount\":\"0.00\",\"agreement_no\":\"20255804217399244554\",\"business_params\":{\"payer_show_name\":\"湛奕辰\",\"payer_show_name_use_alias\":false,\"withdraw_timeliness\":\"T0\"},\"fail_reason\":\"[40004][Business Failed][CARD_BIN_ERROR][收款人银行账号不正确]\",\"channel_sn\":\"AQF20250918234100476107840426\",\"payee_info\":{\"bankcard_ext_info\":{\"account_type\":\"1\",\"inst_name\":\"招商银行\"},\"identity\":\"95\",\"name\":\"张三\",\"identity_type\":\"BANKCARD_ACCOUNT\"},\"order_id\":\"\",\"mch_order_no\":\"fdb9d4346435454354134643be3315\",\"status\":4}",
    "msg": "请求成功",
    "sign": "WN6hi/D7GK2JnfuMqhA+5AjoGXpoSDS9Ej/inx7nP5rrDlt6MQ3NlPijwfiJOmByGpYAEda9GkcK6SotzVwzYGREkA48Pnw0bOutuEi/B3Ht4Se8c8bu8kF72yiTSY/bCRZGxD7bZ9gPN4qdAOcEbNknlH1PxCVaZYxTh4I/YHJ8m4CPmr4x0vCTGODWJyNeaExJgifCbzz+uGLgEePHxXDFTcHCT/n7YEHC/xu0EKVWX7cu6cb65o5zgSGbycS9eYWtYFUsabBd8myiekZq6QxiyijuDA8KRBtuWCNo2ULnJikLk4g9I3hq0M+BjE+8QJhGnyJwmxWS0qUz4mLWNQ==",
    "signType": "RSA2",
    "timestamp": 1763042195135
}

2.1 接口格式定义

1. 协议规则#

1.1接入方对接API须遵循以下规则：#

2. 公共参数#

2.1 通用报文格式#

2.2 报文示例#

1. 协议规则

1.1接入方对接API须遵循以下规则：

2. 公共参数

2.1 通用报文格式

2.2 报文示例