> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peere.co/llms.txt
> Use this file to discover all available pages before exploring further.

# guides

# Refund Management

Process refunds and handle payment reversals for your customers.

## What is Refund Management?

<Card title="Payment Reversals" icon="arrow-rotate-left">
  Initiate refunds for completed transactions and track refund status to provide excellent customer service and handle payment disputes.
</Card>

## Key Operations

<CardGroup cols={2}>
  <Card title="Initiate Refund" icon="money-bill-transfer">
    Process refunds for completed transactions
  </Card>

  <Card title="Track Status" icon="magnifying-glass">
    Monitor refund processing status
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Refund Request">Initiate refund for a completed transaction</Step>
  <Step title="Bank Processing">Customer's bank processes the refund request</Step>
  <Step title="Status Updates">Receive real time updates on refund status</Step>
  <Step title="Completion">Funds are returned to customer's account</Step>
</Steps>

### Initiate Refund

<CodeGroup>
  ```json Request theme={null}
  {
    "transactionId": "txn_12345",
    "amount": 1500,
    "reason": "Customer requested refund",
    "refundType": "full"
  }
  ```

  ```bash cURL theme={null}
  curl -X POST "https://api.peere.network/v1/refunds/initiate" \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "transactionId": "txn_12345",
      "amount": 1500,
      "reason": "Customer requested refund"
    }'
  ```
</CodeGroup>

### Check Refund Status

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.peere.network/v1/refunds/{refundId}/status" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```
</CodeGroup>

## Refund Types

<CardGroup cols={2}>
  <Card title="Full Refund" icon="money-bill">
    Refund the complete transaction amount
  </Card>

  <Card title="Partial Refund" icon="money-bill-1">
    Refund a portion of the transaction amount
  </Card>
</CardGroup>

## Refund Status Types

<CardGroup cols={4}>
  <Card title="pending" icon="clock" color="#f59e0b">
    Refund initiated, processing
  </Card>

  <Card title="processing" icon="arrows-rotate" color="#3b82f6">
    Bank is processing refund
  </Card>

  <Card title="completed" icon="check" color="#10b981">
    Refund successfully processed
  </Card>

  <Card title="failed" icon="x" color="#ef4444">
    Refund failed or was rejected
  </Card>
</CardGroup>

## Use Cases

<Tabs>
  <Tab title="Customer Service">Handle customer complaints and service issues by processing refunds quickly.</Tab>
  <Tab title="Order Cancellations">Refund customers when orders are cancelled before fulfillment.</Tab>
  <Tab title="Dispute Resolution">Resolve payment disputes by issuing appropriate refunds.</Tab>
  <Tab title="Service Credits">Provide service credits or compensation through partial refunds.</Tab>
</Tabs>

<Warning>Refunds can only be processed for completed transactions. Ensure the original transaction was successful before attempting a refund.</Warning>

## Processing Times

<Info>Refund processing times vary by bank and payment method. Most refunds are processed within 3 to 5 business days, but some may take longer depending on the customer's bank.</Info>

## Next Steps

After implementing refund management:

1. [Transaction Management](/merchant-apis/transaction-management/overview) to track refund transactions
2. [Customer Decisions](/merchant-apis/customer-decisions/overview) to understand customer permissions