支付寶商戶申訴-接入指引
最近更新時間：2023.7.20
1.產品介紹
1.1簡介
斗拱為渠道商/商戶提供一套在支付寶側側進行旗下風險商戶的申訴功能，在渠道商/商戶登陸控臺后使用該功能可大大減少在支付寶側的交互
1.2相關能力應用場景
支付寶服務商為商戶進行申訴時，根據下發(fā)的風險類型及處罰記錄向支付寶發(fā)起申訴。需要提供申訴證明材料，用于解除賬號的限制以及風險的解除。
SAAS類服務商對接后可以包裝頁面，為自己的商戶提供支付寶申訴能力。
本接口用于服務商查詢下屬商戶在支付寶平臺被投訴的記錄。可以查全部也可以查指定商戶的
1.3適用對象
支付寶的服務商
2.接入前準備
3.開發(fā)指引
3.1對接規(guī)范
- 請求方式：POST
- 支持格式：JSON
- 加簽驗簽說明：請參考接入指引-開發(fā)指南
3.2系統(tǒng)接口
3.2.1支付寶投訴詳情
入參需關注以下字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| sys_id | 商戶/渠道商匯付Id | 渠道商/商戶在匯付側分配的id |
| huifu_id | 被投訴的商戶ID | |
| risk_biz_id | 支付寶投訴流水號 | 示例值：3d1a950325be986f604c19b03988e501-BANK |
| risk_type | 通道風險類型 | 套現,賭博,欺詐,禁限售,優(yōu)惠費率濫用,花唄套現,小程序欺詐,撤訴結案,色情,集資,虛擬幣,未認證,可信商戶,其他,異常交易,營銷作弊,作弊商戶,費率風險,費率調整,涉嫌高風險交易,刷單欺詐投訴 示例值：涉嫌高風險交易 |
返參需關注以下字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| total_count | 投訴總條數 | 條數過多需要分頁處理 |
| complaint_list | 支付寶風險數據 | 包括：風險類型、風險原因說明、通道商戶名稱等 |
3.2.2支付寶申訴請求憑證
| 參數 | 中文名 | 說明 |
|---|---|---|
| risk_biz_id | 支付寶推送流水號 | 示例值：3d1a950325be986f604c19b03988e501-BANK |
| merchant_type | 商戶類型 | 枚舉值：企業(yè)、個體工商戶、小微商戶、事業(yè)單位、政府機關、社會組織 示例值：企業(yè) |
| operation_type | 商戶經營模式 | 枚舉值：線上、線下、線上和線下；示例值：線上和線下 具體參考商戶經營模式說明 |
| payment_scene | 收款應用場景 | 支持多選，用;分號分隔；具體參考收款應用場景 示例值：通過小程序收款;通過APP收款 |
返參需關注以下字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| risk_result | 業(yè)務結果 | 包括：憑證要求、憑證照片等 |
3.3.3支付寶申訴提交說明
| 參數 | 中文名 | 說明 |
|---|---|---|
| risk_biz_id | 支付寶推送流水號 | 示例值：3d1a950325be986f604c19b03988e501-BANK |
| relieving_id | 申請解限唯一Id | 參見投訴請求憑證接口返回的值；一次申訴解限的唯一ID，為請求憑證要求表單時，返回的唯一ID；示例值：b1e11c97badf1ba025399ee0332d8fb1 |
| relieve_cert_data_list | 提交的憑證數據 |
返參需關注以下字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| risk_result | 業(yè)務結果 | 操作結果 |
4.API列表
| 類型 | 功能 | 描述 |
|---|---|---|
| 應用程序接口 | 支付寶投訴查詢 | 本接口用于服務商查詢下屬商戶在支付寶平臺被投訴的記錄。可以查全部也可以查指定商戶的。 |
| 應用程序接口 | 支付寶申訴請求憑證 | 本接口用于發(fā)起申訴，接口返回所需要提供的材料類型。 |
| 應用程序接口 | 支付寶申訴提交憑證 | 本接口用于向支付寶提交憑證材料做申訴。 |
| 應用程序接口 | 支付寶申訴查詢 | 本接口用于服務商查詢下屬商戶申訴的結果。 |
