---
id: refund-payment
title: Refund Payment
description: Guided UI for issuing full or partial refunds with reason codes and audit trails.
sidebar_position: 33
---
import {
CodeBlock,
PropsMarkdownTable,
PartsMarkdownTable,
getWebcomponentsVersion,
getComponentParts,
getPropsFromDocs,
ComponentBox,
setUpMocks,
} from '../helpers';
import docsJson from '../docs.json';
import componentTreeJson from '../component-tree.json';
import '@justifi/webcomponents/dist/module/justifi-refund-payment';
{setUpMocks()}
## Overview
Component to render a form for partially or fully refunding a payment based on a provided payment ID.
## Props, Events & Methods
### Events
- `submit-event`: Emits when the refund is created; payload includes `refund_id` and amount.
- `error-event`: Fires when validation or network calls fail.
### Public methods
1. `refundPayment()` – Trigger the refund flow programmatically (useful if the component is inside a modal with custom buttons).
# Authorization
---
Authorization is performed by passing a web component token as{' '}
auth-token.
Web Component Token: These tokens are generated by your
backend services using the [Web Component Tokens
API](https://docs.justifi.tech/api-spec#tag/Web-Component-Tokens/operation/CreateWebComponentToken).
Each token can be scoped to perform a set number of actions and is active
for 60 minutes. When creating a web component token for this specific
component you'll need to use the role: `write:account:account_id`. Make sure
the value for `account_id` matches the prop you also pass separately.