- 1.总体介绍
- 2.接口规范
- 3.统一交易类
- 4.支付宝产品类
- 5.订单分账类
- 6.余额分账类
- 6.1 余额分账指引
- 6.2 余额分账接口
- 7.风控管理类
- 7.1 投诉管理类
- 7.2 风险管理类
- 8.商户管理类
- 9. 先享后付类
- 10.账户管理类
- 产品手册
- 回收站
- 数据模型
- 公共请求参数
- 公共返回参数
- 公共响应结构
- 商户入网材料
- 业务请求参数
- 营业执照信息
- 文件上传请求
- 法人证件信息
- 商户入网请求
- 结算卡信息
- 进件标识查询请求
- 入网查询请求
- 结算卡变更请求
- 产品变更请求
- 结算卡更新信息
- 变更查询请求
- AUT查询请求
- 分账关系绑定请求
- AUT微信配置请求
- 分账关系解绑请求
- AUT配置详情查询请求
- 分账关系更新请求
- 微信支付配置响应
- 分账关系查询请求
- 授权目录配置状态
- 商户入网响应
- AppId配置状态
- 商户变更响应
- AUT拆分请求
- 变更审核状态响应
- 商户基本信息
- 分账关系响应
- 人员证件信息
- 余额分账申请请求
- 商户营业执照信息
- 余额分账明细请求
- 商户经营信息
- 分账查询请求
- 经营场景信息
- 分账退款申请请求
- 经营资质信息
- 分账退款明细请求
- 商户结算卡信息
- 分账退款查询请求
- 对公卡信息
- 余额分账响应
- 签约信息
- 分账明细响应
- 产品开通信息
- 余额分账退款响应
- 产品配置详情
- 分账退款明细响应
- AUT查询响应
- 提现申请请求
- 异步通知响应结构
- 提现查询请求
- 进件状态通知数据
- 提现响应数据
- 变更状态通知数据
- 入网报备通知数据
- 余额分账通知数据
- 分账明细通知
- 余额退款通知数据
- 提现通知数据
- 退款明细通知
4.1.2.1 单笔转账接口
正式环境
https://openapi.3ypay.com
正式环境
https://openapi.3ypay.com
POST
/aqf-openapi/openapi/transfer/singleTransfer
2、通过接口下发付款均无需人工审核，由于付款是实时的所以均无法撤销，请一定要核对清楚以后再进行下发
3、由于支付宝安全发手续费扣费方式为扣除服务商支付宝账户余额，并不会从交易订单内扣除，根据监管要求我司也无法直接从客户备付金账户划转，所以我司采用手续费预存外扣形式扣除交易手续费，还望理解
4、http状态码非200时请勿判断该订单为失败状态，可能是网关系统超时或内部通讯异常导致，实际上服务网关已接收到该笔请求并已进入处理流程，应调用查询接口查询该笔订单终态，确定的确未下发或者下发失败以后再决定是否重新下发
5、当code返回码为500500以上也有可能是OPENAPI网关超时或异常导致实际上服务网关已接收到该笔请求并已进入处理流程，应调用查询接口查询该笔订单终态，确定的确未下发或者下发失败以后再决定是否重新下发
6、下发状态只有4等于成功，2、5为失败状态，6为退票（转账成功后银行退款），其他均为中间状态，不可判定为失败，状态值可能存在非文档枚举状态，请一律视为转账中状态
请求参数
Body 参数application/json必填
示例
{
"appId": "APP_xxxxxxx",
"timestamp": 1762845607144,
"requestId": "e34ec4043d4c3a3a16c0d8d533431d3b",
"version": "1.0",
"signType": "RSA2",
"charset": "UTF-8",
"bizContent": "{\"account_book_id\":\"2088970907720362\",\"mch_order_no\":\"fdb9d43464353454354134643be3315\",\"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": "F5HIU3hHqXD86lKGGq3OnC1WP62k8tItYLdcDinySr7Vy+FnUYDG5ZtrTiR1U+j8NjTurxHPdllgeBKhCyj5/CgAewurZk2WD0bNsGrp9RntuJROLHEanggjtNkWQuLJG1wlkIV/QQWaVXA8LaqGpwiDDXQiENXVkO6gJ+G9y3I6Vo2Ww8O2srir8mw2zaeYJzoDYYxcB8BDsyRyPIn+fFL3nbOiVglzjUEbU2Jf8ugMiXvo+IMTfdIQPELlnwMzuWLPXL4zY5QohSexfpgngP/Ovg/qz/XOG/9v8m4oLTlaqnX3Y+X1MZtseu6SWvq6Eo9BM7747u8JKH+7GoN4hw=="
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.3ypay.com/aqf-openapi/openapi/transfer/singleTransfer' \
--header 'Content-Type: application/json' \
--data '{
"appId": "APP_xxxxxxx",
"timestamp": 1762845607144,
"requestId": "e34ec4043d4c3a3a16c0d8d533431d3b",
"version": "1.0",
"signType": "RSA2",
"charset": "UTF-8",
"bizContent": "{\"account_book_id\":\"2088970907720362\",\"mch_order_no\":\"fdb9d43464353454354134643be3315\",\"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": "F5HIU3hHqXD86lKGGq3OnC1WP62k8tItYLdcDinySr7Vy+FnUYDG5ZtrTiR1U+j8NjTurxHPdllgeBKhCyj5/CgAewurZk2WD0bNsGrp9RntuJROLHEanggjtNkWQuLJG1wlkIV/QQWaVXA8LaqGpwiDDXQiENXVkO6gJ+G9y3I6Vo2Ww8O2srir8mw2zaeYJzoDYYxcB8BDsyRyPIn+fFL3nbOiVglzjUEbU2Jf8ugMiXvo+IMTfdIQPELlnwMzuWLPXL4zY5QohSexfpgngP/Ovg/qz/XOG/9v8m4oLTlaqnX3Y+X1MZtseu6SWvq6Eo9BM7747u8JKH+7GoN4hw=="
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"appId": "APP_01863208408",
"code": 200,
"data": "{\"order_title\":\"踢脚线驳船哼尽管关于\",\"account_book_id\":\"2088970907720362\",\"agreement_no\":\"20255804217399244554\",\"business_params\":{\"payer_show_name\":\"湛奕辰\",\"payer_show_name_use_alias\":false,\"withdraw_timeliness\":\"T0\"},\"remark\":\"veniam fugiat sunt\",\"out_biz_no\":\"N202511111520127275\",\"trans_amount\":\"0.1\",\"product_code\":\"AQF-TRANSFER-BANKCARD\",\"channel_sn\":\"AQF20250918234100476107840426\",\"payee_info\":{\"bankcard_ext_info\":{\"account_type\":\"1\",\"inst_name\":\"招商银行\"},\"identity\":\"95\",\"name\":\"张三\",\"identity_type\":\"BANKCARD_ACCOUNT\"},\"mch_order_no\":\"fdb9d43464353454354134643be3315\",\"status\":1}",
"msg": "请求成功",
"sign": "Dpbtp7kycRlPNYtD9E6+KSXZSmHhhkueIZejxQjfGNcttBdE35EzBZBn1ceKSLVKsCXOBt409TMpM3Pi4fRoO1gx2hN6efbHdA9PinkzFETelyMq6mSsUm7q2kvdqfNC7WvbGrTvMHbU62mHH5fby7i1BrZGJszpnHxUJ3a13dKz6yCgdTFmUDJv4A05T76VE2dtLgbaS+kL29NuO6uFjaczslfBGujYnNbJ0UsCqLxvJ6Pty6GISila9YrSWdIvAGnXjUOiePLTeFBRuFUjMdpx8vKCssG5hFEQEoMqsw9GADfjGBB/NYjiQeVbI+cc5Un0JvHPBpIpp+bpqN+w8w==",
"signType": "RSA2",
"timestamp": 1762845613440
}