---
title: "Reverse a commission"
method: PATCH
path: "/affiliate-commissions/{id}"
tags: ["Affiliates"]
---

# Reverse a commission

`PATCH /affiliate-commissions/{id}`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/affiliate-commissions/{id}`
- Auth: HTTP bearer

The only supported change is `status: "reversed"`, for a pending or earned commission that is not part of a payout. Refunds and disputes in Stripe reverse commissions on their own.

## Request body

- UpdateAffiliateCommissionRequest
  - `status` 'reversed', required
  - `reason` 'manual' | 'fraud'
  - `note` string

## Response `200`

The reversed commission

- AffiliateCommissionResponse
  - `commission` AffiliateCommission, required
    - `object` 'affiliate_commission', required
    - `id` string, required
    - `affiliate_id` string, required
    - `referral_id` string, nullable
    - `tier` 1 | 2, required: 2 = second-tier (recruiter) commission
    - `status` 'pending' | 'earned' | 'paid' | 'reversed', required
    - `amount_cents` integer, required
    - `sale_amount_cents` integer
    - `currency` string, required
    - `description` string, nullable
    - `stripe_invoice_id` string, nullable
    - `stripe_charge_id` string, nullable
    - `earns_at` string, date-time, required: When the hold ends and a pending commission becomes earned
    - `earned_at` string, date-time, nullable
    - `paid_at` string, date-time, nullable
    - `reversed_at` string, date-time, nullable
    - `reverse_reason` 'refund' | 'partial_refund' | 'dispute' | 'manual' | 'fraud', nullable
    - `payout_id` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: Validation error (`details.fields` names each bad field)
- `401`: Missing or invalid API key
- `403`: The API key is not full access, or the action is not allowed
- `404`: Not found in this account
- `409`: Conflict

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)