Linkkit
Dashboard

Tracking refunds

Learn how to record and manage refund events for your LinkKit partner program.

Learn how to record and manage refund events for your LinkKit partner program.

Business Plan Requirement
This feature is only available on LinkKit Business plans and above.

If you’re using LinkKit Partners for your affiliate program, you may also want to track refund events and update the status of the related partner commissions accordingly.

Commission Refunds and Clawbacks
Commissions that have already been paid cannot be refunded. To handle this, set a payout holding period that matches your company’s refund policy. For example, if your refund policy is 30 days, set the payout holding period to 30 days. If you need to reverse a commission that has already been paid, you can create a clawback instead.

Tracking Refunds with the Stripe Integration

Good news — if you’re using the LinkKit Stripe integration, refund events are tracked automatically without requiring any additional configuration.

Tracking Refunds Manually

If you’re not using the LinkKit Stripe integration and are tracking sales manually, you can track refunds by following these steps:

1. Include invoiceId When Tracking a Sale

When sending a sale event using POST /track/sale, make sure to include a unique invoiceId value that identifies the specific transaction.

2. Find the Related Commission

When a refund occurs, locate the corresponding commission by searching your commissions using the same invoiceId that was provided when tracking the sale.

3. Update the Commission Status

Finally, use the PATCH /commissions/{id} endpoint to update the commission status to refunded.

Once updated, the refunded commission will be excluded from any pending partner payouts.