---
title: "转化作废"
id: "1424"
type: "docs"
slug: "conversion-void"
published_at: "2026-09-07T06:15:08+00:00"
modified_at: "2026-09-07T06:15:08+00:00"
url: "https://www.partnershare.net/help/api/conversion-void"
markdown_url: "https://www.partnershare.net/help/api/conversion-void.md"
excerpt: "转化作废接口用于在付费转化被判定无效时，撤销该转化产生的奖励。 接口按 transaction_id 定位转化 […]"
taxonomy_doc_category:
  - "技术集成"
---

![快速入门 - PartnerShare](https://www.partnershare.net/wp-content/uploads/2026/01/lQLPJyGF1y8mfltQULD6hr47Eio3cwlDF3jyDucB_80_80.png)

## 快速入门

5

- [什么是推荐营销/老带新计划](https://www.partnershare.net/help/start-guides/referral-marketing)
- [什么是联盟营销](https://www.partnershare.net/help/start-guides/affiliate-marketing)
- [如何创建推荐计划](https://www.partnershare.net/help/start-guides/add-referral-marketing)
- [如何创建联盟营销活动](https://www.partnershare.net/help/start-guides/add-affiliate-marketing)
- [如何提升推广效果](https://www.partnershare.net/help/start-guides/improving-promotion-effectiveness)

![合作伙伴管理 - PartnerShare](https://www.partnershare.net/wp-content/uploads/2026/01/lQLPKHuo_8Hse9tQULBcxdOVHL3PdwlDF3jyDucC_80_80.png)

## 推广运营

5

- [活动管理](https://www.partnershare.net/help/promoters/%e6%b4%bb%e5%8a%a8%e7%ae%a1%e7%90%86)
- [产品管理](https://www.partnershare.net/help/promoters/%e4%ba%a7%e5%93%81%e7%ae%a1%e7%90%86)
- [推广者管理](https://www.partnershare.net/help/promoters/data)
- [合作伙伴支持的提现方式](https://www.partnershare.net/help/promoters/withdrawal-methods)
- [查询合作伙伴提现状态](https://www.partnershare.net/help/promoters/withdrawal-status)

![支付与交易 - ParterShare](https://www.partnershare.net/wp-content/uploads/2026/01/lQLPJwyP0mL5vltQULAn8_2d-Nx0hglDF3jyZ0QA_80_80.png)

## 支付与交易

2

- [佣金结算](https://www.partnershare.net/help/payment/commission)
- [提现托管功能](https://www.partnershare.net/help/payment/auto-payouts)

![合作伙伴管理 - PartnerShare](https://www.partnershare.net/wp-content/uploads/2026/01/lQLPKHuo_8Hse9tQULBcxdOVHL3PdwlDF3jyDucC_80_80.png)

## 账户管理

2

- [团队管理功能](https://www.partnershare.net/help/team/%e5%9b%a2%e9%98%9f%e7%ae%a1%e7%90%86%e5%8a%9f%e8%83%bd)
- [企业认证提示](https://www.partnershare.net/help/team/certification)

![技术集成 - PartnerShare](https://www.partnershare.net/wp-content/uploads/2026/01/lQLPJwDplrTBzltQULCNPWCeBswcaAlDF3jyZ0QB_80_80.png)

## 技术集成

8

- [API 鉴权与签名机制](https://www.partnershare.net/help/api/signature)
- [推广转化事件回传](https://www.partnershare.net/help/api/event-report)
- [推广点击跟踪 SDK 接入](https://www.partnershare.net/help/api/sdk)
- [转化退款](https://www.partnershare.net/help/api/conversion-refund)
- [转化作废](https://www.partnershare.net/help/api/conversion-void)
- [将 PartnerShare 内嵌到产品中](https://www.partnershare.net/help/api/iframe)
- [推广者资源接口](https://www.partnershare.net/help/api/promoter-resources)
- [PartnerShare 产品授权推广登录接入指南](https://www.partnershare.net/help/api/partnershare-integration)

![常见问题 - PartnerShare](https://www.partnershare.net/wp-content/uploads/2026/01/lQLPJwbpuanIXltQULBfzi8WsAsVUQlDF3jyDucA_80_80.png)

## 常见问题

2

- [旧版帮助中心入口](https://www.partnershare.net/help/faq/%e6%97%a7%e7%89%88%e5%b8%ae%e5%8a%a9%e4%b8%ad%e5%bf%83%e5%85%a5%e5%8f%a3)
- [提现相关](https://www.partnershare.net/help/faq/withdrawal)

![Image](https://www.partnershare.net/wp-content/uploads/2026/03/B706BBD1-A488-44A9-B7CC-AD90B607DD45-150x150.png)

## 更新日志

2

- [更新日志 – 2026.05.15](https://www.partnershare.net/help/update/%e6%9b%b4%e6%96%b0%e6%97%a5%e5%bf%97-2025-05-15)
- [更新日志-2026.03.05](https://www.partnershare.net/help/update/update2026-3-5)

View Categories

转化作废接口用于在付费转化被判定无效时，撤销该转化产生的奖励。

接口按 `transaction_id` 定位转化记录，取消尚未支付的奖励，并将该转化从付费统计中剔除。

转化因订单全额退款需要撤销时，使用 [转化退款](https://www.partnershare.net/help/api/conversion-refund)
 接口。

### 1. 接口信息 [#](#0-toc-title)

POST`/api/open/v1/track/void`

| 项目 | 说明 |
| --- | --- |
| 请求域名 | https://api-service.partnershare.net |
| 请求格式 | application/json |
| 鉴权 | X-Api-Key + X-Api-Timestamp + X-Api-Sign，签名算法见 API 鉴权与签名机制 |
| 支持的 API Key 版本 | v2 |
| 权限 | 密钥配置了权限列表时需包含 conversion:adjust；未配置权限列表的密钥不受限制 |
| 调用方 | 品牌方服务端 |
| 幂等 | 同一 transaction_id 重复调用返回 ALREADY_PROCESSED，不重复处理 |
| 适用场景 | 转化本身无效：拒付、欺诈、重复下单、测试订单等 |

### 2. 请求头 [#](#1-toc-title)

| Header | 必填 | 说明 |
| --- | --- | --- |
| X-Api-Key | 是 | v2 密钥的 API Key |
| X-Api-Timestamp | 是 | 秒级 Unix 时间戳，300 秒内有效 |
| X-Api-Sign | 是 | v2 签名，签名覆盖请求体原文 |
| Content-Type | 是 | application/json |

### 3. 请求参数 [#](#2-toc-title)

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| transaction_id | string | 是 | 转化上报时传入的 transaction_id，前后空白会被去除，最长 255 字符。同一产品下必须唯一匹配一条转化 |
| reason | string | 否 | 作废原因，最长 255 字符。写入转化记录和被取消奖励的备注，空字符串按未传处理 |

### 4. 处理规则 [#](#3-toc-title)

- 按当前 API Key 所属产品 + `transaction_id` 查找转化。未找到时返回 `1000001`；匹配到多条记录时返回 `1000005`，接口不作处理。
- 只允许调整付费类转化：`purchase` 事件，或带正数 `conversion_value` 的自定义事件。注册等非付费转化返回 `1000005`。
- 该转化下状态为待审核或已通过的奖励（含下游子奖励）改为已拒绝，备注追加 `API转化作废` 及 `reason`。
- 已支付的奖励不作变更，仅在响应的 `preserved_paid_*` 字段中计数。
- 作废后的转化不再计入付费人数、转化金额等付费统计。
- 同一转化只能调整一次。已退款的转化调用本接口返回 `6000000`。
- 调整在单个事务内完成，失败时不产生部分变更。

### 5. 请求示例 [#](#4-toc-title)

```
curl -X POST "https://api-service.partnershare.net/api/open/v1/track/void" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: pk_xxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Api-Timestamp: 1776677721" \
  -H "X-Api-Sign: 50793d436de0dceee25f7e094e298d1af8bd262329d0787569e7d9cdc8fe2980" \
  -d '{"transaction_id":"order_202604220002","reason":"chargeback"}'
```

示例签名以 `api_secret = sk_your_api_secret` 计算，可用于校验签名实现。发送的请求体必须与参与签名的字符串完全一致。

### 6. 响应 [#](#5-toc-title)

#### 6.1 成功 [#](#6-toc-title)

```
{
  "code": 0,
  "message": "Conversion adjustment applied successfully",
  "data": {
    "conversion_id": 1024,
    "transaction_id": "order_202604220002",
    "adjustment_type": 2,
    "status": "APPLIED",
    "cancelled_reward_count": 1,
    "preserved_paid_reward_count": 0,
    "cancelled_sub_reward_count": 0,
    "preserved_paid_sub_reward_count": 0,
    "adjusted_at": "2026-04-22 15:20:31"
  }
}
```

#### 6.2 重复调用 [#](#7-toc-title)

```
{
  "code": 0,
  "message": "Conversion adjustment has already been processed",
  "data": {
    "conversion_id": 1024,
    "transaction_id": "order_202604220002",
    "adjustment_type": 2,
    "status": "ALREADY_PROCESSED",
    "cancelled_reward_count": 0,
    "preserved_paid_reward_count": 0,
    "cancelled_sub_reward_count": 0,
    "preserved_paid_sub_reward_count": 0,
    "adjusted_at": "2026-04-22 15:20:31"
  }
}
```

#### 6.3 响应字段 [#](#8-toc-title)

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| conversion_id | int | PartnerShare 转化记录 ID |
| transaction_id | string | 转化记录上的交易号 |
| adjustment_type | int | 作废固定为 2 |
| status | string | APPLIED 本次处理生效；ALREADY_PROCESSED 此前已按作废处理，本次未做变更 |
| cancelled_reward_count | int | 本次取消的奖励条数 |
| preserved_paid_reward_count | int | 已支付、未取消的奖励条数 |
| cancelled_sub_reward_count | int | 本次取消的下游子奖励条数 |
| preserved_paid_sub_reward_count | int | 已支付、未取消的下游子奖励条数 |
| adjusted_at | string / null | 调整时间，Y-m-d H:i:s，时区 UTC+8 |

`status` 为 `ALREADY_PROCESSED` 时，各计数字段均为 `0`，不反映首次处理的结果。

### 7. 错误码 [#](#9-toc-title)

业务失败返回 HTTP 200，`code` 非 0，`data` 为 `null`。

| code | message | 原因 |
| --- | --- | --- |
| 1000001 | The conversion for the specified transaction was not found | 当前产品下没有该 transaction_id 的转化 |
| 1000004 | This endpoint requires signature version 2 | 使用了 v1 密钥 |
| 1000004 | Missing required permission: conversion:adjust | 密钥权限列表未包含该权限 |
| 1000004 | 其他鉴权消息 | 见 API 鉴权与签名机制 |
| 1000005 | The transaction_id field is required | transaction_id 为空 |
| 1000005 | The transaction_id field has an invalid format | transaction_id 不是字符串或整数 |
| 1000005 | The transaction_id field must not exceed 255 characters | transaction_id 超过 255 字符 |
| 1000005 | The reason field has an invalid format | reason 不是字符串 |
| 1000005 | The reason field must not exceed 255 characters | reason 超过 255 字符 |
| 1000005 | Multiple conversion records match the specified transaction_id; the request cannot be processed automatically | 同一 transaction_id 对应多条转化 |
| 1000005 | This conversion type does not support refunds or voids | 非付费类转化 |
| 6000000 | This conversion has already been fully refunded and cannot be voided again | 已退款的转化调用作废接口 |
| 6000000 | Failed to apply the conversion adjustment | 服务端异常，可重试；持续出现时请联系 PartnerShare 技术支持 |

### 8. 接入注意事项 [#](#10-toc-title)

- 付费转化上报时应传入唯一的 `transaction_id`，否则无法定位转化记录。
- 作废后该转化及其奖励不再计入统计，请确认转化确实无效后再调用。
- 接口具备幂等性，请求超时后可使用相同参数重试。
- 调整操作不可通过接口撤销，建议先使用测试数据验证签名与流程。

更新 07/09/2026

###### 分享这篇文章 ：

- ![Image](https://www.partnershare.net/wp-content/plugins/betterdocs/assets/images/social/share-icon.svg?v=4.3.4)
- [https://www.facebook.com/sharer/sharer.php?u=https://www.partnershare.net/help/api/conversion-void](https://www.facebook.com/sharer/sharer.php?u=https://www.partnershare.net/help/api/conversion-void)
- [https://twitter.com/intent/tweet?url=https://www.partnershare.net/help/api/conversion-void](https://twitter.com/intent/tweet?url=https://www.partnershare.net/help/api/conversion-void)
- [https://www.linkedin.com/shareArticle?mini=true&url=https://www.partnershare.net/help/api/conversion-void](https://www.linkedin.com/shareArticle?mini=true&url=https://www.partnershare.net/help/api/conversion-void)
- [https://pinterest.com/pin/create/button/?url=https://www.partnershare.net/help/api/conversion-void](https://pinterest.com/pin/create/button/?url=https://www.partnershare.net/help/api/conversion-void)

[转化退款](https://www.partnershare.net/help/api/conversion-refund)
[推广者资源接口](https://www.partnershare.net/help/api/promoter-resources)

大纲 - [1. 接口信息](#0-toc-title)
- [2. 请求头](#1-toc-title)
- [3. 请求参数](#2-toc-title)
- [4. 处理规则](#3-toc-title)
- [5. 请求示例](#4-toc-title)
- [6. 响应](#5-toc-title)
  - [6.1 成功](#6-toc-title)
  - [6.2 重复调用](#7-toc-title)
  - [6.3 响应字段](#8-toc-title)

- [7. 错误码](#9-toc-title)
- [8. 接入注意事项](#10-toc-title)