# 3ypay产品接口文档 ## Docs - 1.总体介绍 [1.1 阅读人员](https://doc.3ypay.com/doc-8005008.md): - 1.总体介绍 [1.2 名词解释](https://doc.3ypay.com/doc-8005014.md): - 1.总体介绍 [1.3 调试工具说明](https://doc.3ypay.com/doc-8015716.md): - 2.接口规范 [2.1 接口格式定义](https://doc.3ypay.com/doc-8005015.md): - 2.接口规范 [2.2 加签验签说明](https://doc.3ypay.com/doc-8005019.md): - 2.接口规范 [2.3 参数说明](https://doc.3ypay.com/doc-8005023.md): - 2.接口规范 [2.5 内部测试版sdk](https://doc.3ypay.com/doc-8268889.md): - 3.统一交易类 > 3.1 统一交易类指引 [3.1.1【微信】 扫码交易指引](https://doc.3ypay.com/doc-8164076.md): - 3.统一交易类 > 3.1 统一交易类指引 [3.1.3【微信】小程序交易指引](https://doc.3ypay.com/doc-8005028.md): - 3.统一交易类 > 3.1 统一交易类指引 [3.1.4【微信】JSAPI交易指引](https://doc.3ypay.com/doc-8009285.md): - 3.统一交易类 > 3.1 统一交易类指引 [3.1.5【微信】APP交易指引](https://doc.3ypay.com/doc-8009383.md): - 3.统一交易类 > 3.1 统一交易类指引 [3.1.6【微信】H5交易指引](https://doc.3ypay.com/doc-8009384.md): - 3.统一交易类 > 3.1 统一交易类指引 [3.1.7【微信】资金管控业务说明](https://doc.3ypay.com/doc-8009385.md): - 3.统一交易类 > 3.1 统一交易类指引 [3.1.8【抖音】APP交易指引](https://doc.3ypay.com/doc-8141467.md): - 3.统一交易类 > 3.1 统一交易类指引 [3.1.9【抖音】H5交易指引](https://doc.3ypay.com/doc-8141468.md): - 5.订单分账类 > 5.1 订单分账指引 > 5.1.1 控台分账指引 [5.1.1.1 控台自动分账指引](https://doc.3ypay.com/doc-8084179.md): - 5.订单分账类 > 5.1 订单分账指引 > 5.1.1 控台分账指引 [5.1.1.2 控台手动分账指引](https://doc.3ypay.com/doc-8084180.md): - 产品手册 [AI智能路由指引-内测](https://doc.3ypay.com/doc-8319305.md): - 产品手册 [商户控台操作手册](https://doc.3ypay.com/doc-8321686.md): - 产品手册 > AT投诉渠道配置 [微信投诉风险渠道配置](https://doc.3ypay.com/doc-8074497.md): - 产品手册 > AT风险处理指引 [微信风控处理指引](https://doc.3ypay.com/doc-8133447.md): - 产品手册 > 抖音支付申请指引 [抖音支付合作商家政策](https://doc.3ypay.com/doc-8141459.md): - 产品手册 > 抖音支付申请指引 [抖音支付申请材料](https://doc.3ypay.com/doc-8141460.md): - 产品手册 > 支付宝可信商户报备 [可信降打扰权益服务介绍](https://doc.3ypay.com/doc-8279217.md): - 产品手册 > 支付宝可信商户报备 [商户可信降打扰(存量客户)](https://doc.3ypay.com/doc-8279219.md): - 产品手册 > 支付宝可信商户报备 [准入可信降打扰(新增客户)](https://doc.3ypay.com/doc-8279220.md): - 产品手册 > 分账相关指引 [分账订阅-商户使用指引](https://doc.3ypay.com/doc-8673594.md): ## API Docs - 3.统一交易类 > 3.2 统一交易类接口 [3.2.1 统一支付接口](https://doc.3ypay.com/api-403504755.md): 1. 当 **支付方式(paySubType)** 为 **用户扫码(NATIVE)** 时仅支持支付宝与银联支付, **微信支付不支持! 请自行调用JSAPI支付** - 3.统一交易类 > 3.2 统一交易类接口 [3.2.2 统一交易查询](https://doc.3ypay.com/api-403504762.md): - 3.统一交易类 > 3.2 统一交易类接口 [3.2.3 统一交易通知](https://doc.3ypay.com/api-403504769.md): 1. 触发条件:订单支付成功且交易时异步通知地址不为空。 - 3.统一交易类 > 3.2 统一交易类接口 [3.2.4 统一退款接口](https://doc.3ypay.com/api-403505033.md): - 3.统一交易类 > 3.2 统一交易类接口 [3.2.5 统一退款查询](https://doc.3ypay.com/api-403505037.md): - 3.统一交易类 > 3.2 统一交易类接口 [3.2.6 统一退款通知](https://doc.3ypay.com/api-403505041.md): 1. 触发条件:退款成功且退款请求中异步通知地址不为空。 - 4.支付宝产品类 > 4.1 安全发接口 > 4.1.2 安全发API接口 [4.1.2.1 单笔转账接口](https://doc.3ypay.com/api-404522405.md): 1、用于充值代付业务。 - 4.支付宝产品类 > 4.1 安全发接口 > 4.1.2 安全发API接口 [4.1.2.2 单笔转账查询](https://doc.3ypay.com/api-404523394.md): - 4.支付宝产品类 > 4.1 安全发接口 > 4.1.2 安全发API接口 [4.1.2.3 转账异步通知](https://doc.3ypay.com/api-404523695.md): 1. 当贵司接收到我司异步通知后请返回http状态码为200,其他状态码系统将判定为通知失败,将会触发重复通知队列,重复通知最大通知次数为20次,第一次重复通知将间隔50秒,后续每一次重复通知按照(通知次数*50)间隔时间进行通知 - 4.支付宝产品类 > 4.1 安全发接口 > 4.1.2 安全发API接口 [4.1.2.4 转账回单申请](https://doc.3ypay.com/api-404524889.md): 1、一般情况下系统会在1分钟后自动申请回单凭证,您可在转账订单成功的1分钟后通过转账回单下载进行下载转账回单凭证,如转账回单下载接口无法下载回单可通过该接口重新申请 - 4.支付宝产品类 > 4.1 安全发接口 > 4.1.2 安全发API接口 [4.1.2.5 转账回单下载](https://doc.3ypay.com/api-404525101.md): 调用该接口报错或回单未生成,可调用转账回单申请接口30秒以后再调用该接口,该接口返回的文件下载地址仅20秒内有效,超过20秒再次访问该文件地址将失效 - 4.支付宝产品类 > 4.2 直付通接口 > 4.2.2 直付通API接口 [4.2.2.1 统一支付接口](https://doc.3ypay.com/api-404428729.md): :::caution[重要] - 4.支付宝产品类 > 4.2 直付通接口 > 4.2.2 直付通API接口 [4.2.2.2 统一交易查询](https://doc.3ypay.com/api-404515292.md): - 4.支付宝产品类 > 4.2 直付通接口 > 4.2.2 直付通API接口 [4.2.2.3 统一交易通知](https://doc.3ypay.com/api-404517659.md): 1. 触发条件:订单支付成功且交易时异步通知地址不为空。 - 4.支付宝产品类 > 4.2 直付通接口 > 4.2.2 直付通API接口 [4.2.2.4 统一交易退款](https://doc.3ypay.com/api-404516143.md): - 4.支付宝产品类 > 4.2 直付通接口 > 4.2.2 直付通API接口 [4.2.2.5 统一退款查询](https://doc.3ypay.com/api-404516975.md): - 4.支付宝产品类 > 4.2 直付通接口 > 4.2.2 直付通API接口 [4.2.2.6 统一退款通知](https://doc.3ypay.com/api-404517396.md): 1. 触发条件:退款成功且退款请求中异步通知地址不为空。 - 4.支付宝产品类 > 4.2 直付通接口 > 4.2.3 支付宝商家转账(定制) [4.2.3.1 支付宝商家转账](https://doc.3ypay.com/api-420363003.md): - 5.订单分账类 > 5.2 订单分账接口 [5.2.1 请求分账](https://doc.3ypay.com/api-408220571.md): ## 一、功能说明 - 5.订单分账类 > 5.2 订单分账接口 [5.2.2 分账查询](https://doc.3ypay.com/api-408223438.md): - 5.订单分账类 > 5.2 订单分账接口 [5.2.3 分账完结](https://doc.3ypay.com/api-408224224.md): - 5.订单分账类 > 5.2 订单分账接口 [5.2.4 分账退款](https://doc.3ypay.com/api-408224464.md): - 5.订单分账类 > 5.2 订单分账接口 [5.2.5 分账退款查询](https://doc.3ypay.com/api-408225801.md): - 5.订单分账类 > 5.2 订单分账接口 [5.2.6 分账结果通知](https://doc.3ypay.com/api-418911159.md): - 5.订单分账类 > 5.2 订单分账接口 [5.2.7 分账退款通知](https://doc.3ypay.com/api-418911254.md): - 6.余额分账类 > 6.2 余额分账接口 [6.2.1 余额分账申请](https://doc.3ypay.com/api-449477403.md): 对商户账户余额发起分账,将余额资金按照指定分账明细列表分配给分账接收方,无需关联支付订单。 - 6.余额分账类 > 6.2 余额分账接口 [6.2.2 余额分账查询](https://doc.3ypay.com/api-449477404.md): 根据分账批次号或商户分账订单号查询余额分账处理状态及明细结果。 - 6.余额分账类 > 6.2 余额分账接口 [6.2.3 余额分账退款](https://doc.3ypay.com/api-449477405.md): 对已完成余额分账的批次发起退款,将分账资金从接收方退回至付款方账户余额。 - 6.余额分账类 > 6.2 余额分账接口 [6.2.4 余额退款查询](https://doc.3ypay.com/api-449477406.md): 根据分账批次号或商户分账订单号查询余额分账退款处理状态及明细。 - 6.余额分账类 > 6.2 余额分账接口 [6.2.5 余额分账异步通知](https://doc.3ypay.com/api-449477411.md): 余额分账完成后,平台主动向商户 notifyUrl 推送分账结果通知。 - 6.余额分账类 > 6.2 余额分账接口 [6.2.6 余额退款异步通知](https://doc.3ypay.com/api-449477413.md): 余额分账退款完成后,平台主动向商户 notifyUrl 推送退款结果通知。 - 8.商户管理类 > 8.1 商户进件类 [8.1.1 进件文件上传](https://doc.3ypay.com/api-449336441.md): 上传进件所需的图片或文件材料。文件内容使用Base64编码传递,返回文件的OSS存储URL。 - 8.商户管理类 > 8.1 商户进件类 [8.1.2 商户入网申请](https://doc.3ypay.com/api-449336442.md): 创建商户进件申请,支持新商户注册+进件(source=1)和存量商户进件(source=0)。 - 8.商户管理类 > 8.1 商户进件类 [8.1.3 商户入网信息查询](https://doc.3ypay.com/api-449336443.md): 查询商户进件申请的详细信息和当前审核状态。accessSn、mchAccessNo、requestId三选一必填。 - 8.商户管理类 > 8.1 商户进件类 [8.1.4 商户结算信息变更](https://doc.3ypay.com/api-449336444.md): 更新商户的银行账户、结算卡等结算相关信息。accessSn与mchAccessNo二选一必填。 - 8.商户管理类 > 8.1 商户进件类 [8.1.5 商户产品信息变更](https://doc.3ypay.com/api-449336445.md): 更新商户开通的支付产品和费率配置。accessSn与mchAccessNo二选一必填。 - 8.商户管理类 > 8.1 商户进件类 [8.1.6 商户信息变更查询](https://doc.3ypay.com/api-449336446.md): 查询商户结算信息变更或产品变更的申请状态和审核进度。accessSn/mchAccessNo二选一,modifyId/mchModifyNo二选一。 - 8.商户管理类 > 8.1 商户进件类 [8.1.7 进件状态通知](https://doc.3ypay.com/api-449336451.md): 进件状态变更时,平台主动向商户notifyUrl推送进件结果通知。 - 8.商户管理类 > 8.1 商户进件类 [8.1.8 变更状态通知](https://doc.3ypay.com/api-449336452.md): 进件变更审核完成后,平台主动向商户notifyUrl推送变更结果通知。 - 8.商户管理类 > 8.2 微信支付宝管理类 [8.2.1 商户AUT报备查询](https://doc.3ypay.com/api-449336447.md): 查询商户在各支付渠道(微信、支付宝、银联等)的AUT报备状态和配置信息。accessSn与mchAccessNo二选一必填。 - 8.商户管理类 > 8.2 微信支付宝管理类 [8.2.2 微信支付配置](https://doc.3ypay.com/api-449336448.md): 配置商户的微信公众号APPID、小程序APPID和授权目录等微信支付相关参数。accessSn与mchAccessNo二选一必填。 - 8.商户管理类 > 8.2 微信支付宝管理类 [8.2.3 微信支付配置查询](https://doc.3ypay.com/api-449336449.md): 查询商户已配置的微信公众号APPID、小程序APPID及授权目录等微信支付参数。accessSn与mchAccessNo二选一必填。 - 8.商户管理类 > 8.2 微信支付宝管理类 [8.2.4 商户AUT拆分](https://doc.3ypay.com/api-449336450.md): 将商户AUT报备进行拆分操作,支持按渠道类型拆分。accessSn与mchAccessNo二选一必填。 - 8.商户管理类 > 8.3 分账接收方管理类 [分账接收方录入](https://doc.3ypay.com/api-449477395.md): 提交非收单商户的入网申请,将分账接收方商户信息报备至支付渠道。 - 8.商户管理类 > 8.3 分账接收方管理类 [分账接收方查询](https://doc.3ypay.com/api-449477396.md): 查询非收单商户的入网进件信息及当前报备状态。 - 8.商户管理类 > 8.3 分账接收方管理类 [分账接收方变更](https://doc.3ypay.com/api-449477397.md): 申请修改非收单商户的结算卡信息(开户行、银行卡号、结算周期等)。 - 8.商户管理类 > 8.3 分账接收方管理类 [分账变更查询](https://doc.3ypay.com/api-449477398.md): 查询非收单商户信息变更申请的审核进度及结果。 - 8.商户管理类 > 8.3 分账接收方管理类 [分账关系绑定](https://doc.3ypay.com/api-449477399.md): 将分账接收方账号与商户应用通道进行绑定,建立分账关系。 - 8.商户管理类 > 8.3 分账接收方管理类 [分账关系解绑](https://doc.3ypay.com/api-449477400.md): 解除分账接收方账号与商户应用通道之间的绑定关系。 - 8.商户管理类 > 8.3 分账接收方管理类 [分账关系更新](https://doc.3ypay.com/api-449477401.md): 更新已绑定的分账关系配置,包括分账比例、费率、是否秒到、是否自动分账等参数。 - 8.商户管理类 > 8.3 分账接收方管理类 [分账关系查询](https://doc.3ypay.com/api-449477402.md): 查询指定应用通道下已绑定的分账接收方关系列表及配置详情。 - 8.商户管理类 > 8.3 分账接收方管理类 [入网报备通知](https://doc.3ypay.com/api-449477409.md): 分账接收方入网报备完成后,平台主动向商户 notifyUrl 推送报备结果通知。 - 8.商户管理类 > 8.3 分账接收方管理类 [结算变更通知](https://doc.3ypay.com/api-449477410.md): 分账接收方结算卡变更审核完成后,平台主动向商户 notifyUrl 推送变更结果通知。 - 10.账户管理类 > 10.1.分账提现管理类 [10.1.1 分账提现申请](https://doc.3ypay.com/api-449477407.md): 对分账接收方账号发起提现申请,将分账接收的资金提现到对应的结算卡。 - 10.账户管理类 > 10.1.分账提现管理类 [10.1.2 分账提现查询](https://doc.3ypay.com/api-449477408.md): 根据商户提现单号或请求流水号查询提现处理状态及详细信息(二选一必填)。 - 10.账户管理类 > 10.1.分账提现管理类 [10.1.3 提现结果通知](https://doc.3ypay.com/api-449477412.md): 分账提现完成后,平台主动向商户 notifyUrl 推送提现结果通知。 ## Schemas - [公共请求参数](https://doc.3ypay.com/schema-237261487.md): - [公共返回参数](https://doc.3ypay.com/schema-237676336.md): - [公共响应结构](https://doc.3ypay.com/schema-268405290.md): - [商户入网材料](https://doc.3ypay.com/schema-268519463.md): - [业务请求参数](https://doc.3ypay.com/schema-268405291.md): - [营业执照信息](https://doc.3ypay.com/schema-268519464.md): - [文件上传请求](https://doc.3ypay.com/schema-268405292.md): - [法人证件信息](https://doc.3ypay.com/schema-268519465.md): - [商户入网请求](https://doc.3ypay.com/schema-268405293.md): - [结算卡信息](https://doc.3ypay.com/schema-268519466.md): - [进件标识查询请求](https://doc.3ypay.com/schema-268405294.md): - [入网查询请求](https://doc.3ypay.com/schema-268519467.md): - [结算卡变更请求](https://doc.3ypay.com/schema-268405295.md): - [产品变更请求](https://doc.3ypay.com/schema-268405296.md): - [结算卡更新信息](https://doc.3ypay.com/schema-268519468.md): - [变更查询请求](https://doc.3ypay.com/schema-268405297.md): - [AUT查询请求](https://doc.3ypay.com/schema-268405298.md): - [分账关系绑定请求](https://doc.3ypay.com/schema-268519469.md): - [AUT微信配置请求](https://doc.3ypay.com/schema-268405299.md): - [分账关系解绑请求](https://doc.3ypay.com/schema-268519470.md): - [AUT配置详情查询请求](https://doc.3ypay.com/schema-268405300.md): - [分账关系更新请求](https://doc.3ypay.com/schema-268519471.md): - [微信支付配置响应](https://doc.3ypay.com/schema-268405301.md): - [分账关系查询请求](https://doc.3ypay.com/schema-268519472.md): - [授权目录配置状态](https://doc.3ypay.com/schema-268405302.md): - [商户入网响应](https://doc.3ypay.com/schema-268519473.md): - [AppId配置状态](https://doc.3ypay.com/schema-268405303.md): - [商户变更响应](https://doc.3ypay.com/schema-268519474.md): - [AUT拆分请求](https://doc.3ypay.com/schema-268405304.md): - [变更审核状态响应](https://doc.3ypay.com/schema-268519475.md): - [商户基本信息](https://doc.3ypay.com/schema-268405305.md): - [分账关系响应](https://doc.3ypay.com/schema-268519476.md): - [人员证件信息](https://doc.3ypay.com/schema-268405306.md): - [余额分账申请请求](https://doc.3ypay.com/schema-268519477.md): - [商户营业执照信息](https://doc.3ypay.com/schema-268405307.md): - [余额分账明细请求](https://doc.3ypay.com/schema-268519478.md): - [商户经营信息](https://doc.3ypay.com/schema-268405308.md): - [分账查询请求](https://doc.3ypay.com/schema-268519479.md): - [经营场景信息](https://doc.3ypay.com/schema-268405309.md): - [分账退款申请请求](https://doc.3ypay.com/schema-268519480.md): - [经营资质信息](https://doc.3ypay.com/schema-268405310.md): - [分账退款明细请求](https://doc.3ypay.com/schema-268519481.md): - [商户结算卡信息](https://doc.3ypay.com/schema-268405311.md): - [分账退款查询请求](https://doc.3ypay.com/schema-268519482.md): - [对公卡信息](https://doc.3ypay.com/schema-268405312.md): - [余额分账响应](https://doc.3ypay.com/schema-268519483.md): - [签约信息](https://doc.3ypay.com/schema-268405313.md): - [分账明细响应](https://doc.3ypay.com/schema-268519484.md): - [产品开通信息](https://doc.3ypay.com/schema-268405314.md): - [余额分账退款响应](https://doc.3ypay.com/schema-268519485.md): - [产品配置详情](https://doc.3ypay.com/schema-268405315.md): - [分账退款明细响应](https://doc.3ypay.com/schema-268519486.md): - [AUT查询响应](https://doc.3ypay.com/schema-268405316.md): - [提现申请请求](https://doc.3ypay.com/schema-268519487.md): - [异步通知响应结构](https://doc.3ypay.com/schema-268405317.md): - [提现查询请求](https://doc.3ypay.com/schema-268519488.md): - [进件状态通知数据](https://doc.3ypay.com/schema-268405318.md): - [提现响应数据](https://doc.3ypay.com/schema-268519489.md): - [变更状态通知数据](https://doc.3ypay.com/schema-268405319.md): - [入网报备通知数据](https://doc.3ypay.com/schema-268519490.md): - [余额分账通知数据](https://doc.3ypay.com/schema-268519491.md): - [分账明细通知](https://doc.3ypay.com/schema-268519492.md): - [余额退款通知数据](https://doc.3ypay.com/schema-268519493.md): - [提现通知数据](https://doc.3ypay.com/schema-268519494.md): - [退款明细通知](https://doc.3ypay.com/schema-268519495.md):