支付宝商户申诉-接入指引
最近更新时间：2023.7.20
1.产品介绍
1.1简介
斗拱为渠道商/商户提供一套在支付宝侧侧进行旗下风险商户的申诉功能，在渠道商/商户登陆控台后使用该功能可大大减少在支付宝侧的交互
1.2相关能力应用场景
支付宝服务商为商户进行申诉时，根据下发的风险类型及处罚记录向支付宝发起申诉。需要提供申诉证明材料，用于解除账号的限制以及风险的解除。
SAAS类服务商对接后可以包装页面，为自己的商户提供支付宝申诉能力。
本接口用于服务商查询下属商户在支付宝平台被投诉的记录。可以查全部也可以查指定商户的
1.3适用对象
支付宝的服务商
2.接入前准备
3.开发指引
3.1对接规范
- 请求方式：POST
- 支持格式：JSON
- 加签验签说明：请参考接入指引-开发指南
3.2系统接口
3.2.1支付宝投诉详情
入参需关注以下字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| sys_id | 商户/渠道商汇付Id | 渠道商/商户在汇付侧分配的id |
| huifu_id | 被投诉的商户ID | |
| risk_biz_id | 支付宝投诉流水号 | 示例值：3d1a950325be986f604c19b03988e501-BANK |
| risk_type | 通道风险类型 | 套现,赌博,欺诈,禁限售,优惠费率滥用,花呗套现,小程序欺诈,撤诉结案,色情,集资,虚拟币,未认证,可信商户,其他,异常交易,营销作弊,作弊商户,费率风险,费率调整,涉嫌高风险交易,刷单欺诈投诉 示例值：涉嫌高风险交易 |
返参需关注以下字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| total_count | 投诉总条数 | 条数过多需要分页处理 |
| complaint_list | 支付宝风险数据 | 包括：风险类型、风险原因说明、通道商户名称等 |
3.2.2支付宝申诉请求凭证
| 参数 | 中文名 | 说明 |
|---|---|---|
| risk_biz_id | 支付宝推送流水号 | 示例值：3d1a950325be986f604c19b03988e501-BANK |
| merchant_type | 商户类型 | 枚举值：企业、个体工商户、小微商户、事业单位、政府机关、社会组织 示例值：企业 |
| operation_type | 商户经营模式 | 枚举值：线上、线下、线上和线下；示例值：线上和线下 具体参考商户经营模式说明 |
| payment_scene | 收款应用场景 | 支持多选，用;分号分隔；具体参考收款应用场景 示例值：通过小程序收款;通过APP收款 |
返参需关注以下字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| risk_result | 业务结果 | 包括：凭证要求、凭证照片等 |
3.3.3支付宝申诉提交说明
| 参数 | 中文名 | 说明 |
|---|---|---|
| risk_biz_id | 支付宝推送流水号 | 示例值：3d1a950325be986f604c19b03988e501-BANK |
| relieving_id | 申请解限唯一Id | 参见投诉请求凭证接口返回的值；一次申诉解限的唯一ID，为请求凭证要求表单时，返回的唯一ID；示例值：b1e11c97badf1ba025399ee0332d8fb1 |
| relieve_cert_data_list | 提交的凭证数据 |
返参需关注以下字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| risk_result | 业务结果 | 操作结果 |
4.API列表
| 类型 | 功能 | 描述 |
|---|---|---|
| 应用程序接口 | 支付宝投诉查询 | 本接口用于服务商查询下属商户在支付宝平台被投诉的记录。可以查全部也可以查指定商户的。 |
| 应用程序接口 | 支付宝申诉请求凭证 | 本接口用于发起申诉，接口返回所需要提供的材料类型。 |
| 应用程序接口 | 支付宝申诉提交凭证 | 本接口用于向支付宝提交凭证材料做申诉。 |
| 应用程序接口 | 支付宝申诉查询 | 本接口用于服务商查询下属商户申诉的结果。 |
