OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	03/26/2025 04:24:35 AM	rwxr-xr-x
📄 Iin.md	1.78 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 account.md	14.21 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 addon.md	4.43 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 card.md	18.73 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 customer.md	10.8 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 dispute.md	6.03 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 document.md	1.82 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 emandate.md	15.61 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 fund.md	2.45 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 invoice.md	18.3 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 item.md	5.43 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 linkedAccount.md	6.06 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 order.md	13.8 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 papernach.md	21.57 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 payment.md	27.06 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 paymentLink.md	33.42 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 paymentVerfication.md	3.79 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 plan.md	4.52 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 productConfiguration.md	18.5 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 qrcode.md	13.92 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 refund.md	7.89 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 registeremandate.md	14.46 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 registernach.md	18.99 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 settlement.md	15.66 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 stakeholder.md	10.5 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 subscription.md	20.73 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 token.md	10.18 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 transfer.md	22.14 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 upi.md	16.8 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 virtualaccount.md	15.68 KB	03/26/2025 04:23:15 AM	rw-r--r--
📄 webhook.md	6.89 KB	03/26/2025 04:23:15 AM	rw-r--r--

Editing: refund.md

## Refunds

### Create a normal refund
```php
$api->payment->fetch($paymentId)->refund(array("amount"=> "100", "speed"=>"normal", "notes"=>array("notes_key_1"=>"Beam me up Scotty.", "notes_key_2"=>"Engage"), "receipt"=>"Receipt No. 31"));
```

**Parameters:**

| Name          | Type        | Description                                 |
|---------------|-------------|---------------------------------------------|
|  paymentId*   | string      | The id of the payment                       |
|  amount       | integer      | The amount to be captured (should be equal to the authorized amount, in paise) |                       |
|  speed        | string      | Here, it must be normal                |
|  notes        | array       | A key-value pair                |
|  receipt      | string      | A unique identifier provided by you for your internal reference. |

**Response:**
```json
{
  "id": "rfnd_FP8QHiV938haTz",
  "entity": "refund",
  "amount": 500100,
  "receipt": "Receipt No. 31",
  "currency": "INR",
  "payment_id": "pay_FCXKPFtYfPXJPy",
  "notes": [],
  "acquirer_data": {
    "arn": null
  },
  "created_at": 1597078866,
  "batch_id": null,
  "status": "processed",
  "speed_processed": "normal",
  "speed_requested": "normal"
}
```
-------------------------------------------------------------------------------------------------------

### Create an instant refund
```php
$api->payment->fetch($paymentId)->refund(array("amount"=> "100","speed"=>"optimum","receipt"=>"Receipt No. 31"));
```

**Parameters:**

| Name          | Type        | Description                                 |
|---------------|-------------|---------------------------------------------|
|  paymentId*  | string      | The id of the payment                       |
|  amount       | integer      | The amount to be captured (should be equal to the authorized amount, in paise) |
|  speed*        | string      | Here, it must be optimum                    |
|  receipt      | string      | A unique identifier provided by you for your internal reference. |

**Response:**
```json
{
  "id": "rfnd_FP8R8EGjGbPkVb",
  "entity": "refund",
  "amount": 500100,
  "currency": "INR",
  "payment_id": "pay_FC8MmhMBZPKDHF",
  "notes": {
    "notes_key_1": "Tea, Earl Grey, Hot",
    "notes_key_2": "Tea, Earl Grey… decaf."
  },
  "receipt": "Receipt No. 31",
  "acquirer_data": {
    "arn": null
  },
  "created_at": 1597078914,
  "batch_id": null,
  "status": "processed",
  "speed_requested": "optimum"
}
```
-------------------------------------------------------------------------------------------------------

### Fetch multiple refunds for a payment
```php
$api->payment->fetch($paymentId)->fetchMultipleRefund($option);
```

**Parameters:**

| Name  | Type      | Description                                      |
|-------|-----------|--------------------------------------------------|
| paymentId*  | string      | The id of the payment                       |
| from  | timestamp | timestamp after which the payments were created  |
| to    | timestamp | timestamp before which the payments were created |
| count | integer   | number of payments to fetch (default: 10)        |
| skip  | integer   | number of payments to be skipped (default: 0)    |

**Refund:**
```json
{
  "entity": "collection",
  "count": 1,
  "items": [
    {
      "id": "rfnd_FP8DDKxqJif6ca",
      "entity": "refund",
      "amount": 300100,
      "currency": "INR",
      "payment_id": "pay_FIKOnlyii5QGNx",
      "notes": {
        "comment": "Comment for refund"
      },
      "receipt": null,
      "acquirer_data": {
        "arn": "10000000000000"
      },
      "created_at": 1597078124,
      "batch_id": null,
      "status": "processed",
      "speed_processed": "normal",
      "speed_requested": "optimum"
    }
  ]
}
 ```
-------------------------------------------------------------------------------------------------------

### Fetch a specific refund for a payment
```php
$api->payment->fetch($paymentId)->fetchRefund($refundId);
```

**Parameters:**

| Name          | Type        | Description                                 |
|---------------|-------------|---------------------------------------------|
|  paymentId*   | string      | The id of the payment to be fetched        |
|  refundId*   | string      | The id of the refund to be fetched           |

**Response:**
```json
{
  "id": "rfnd_FP8DDKxqJif6ca",
  "entity": "refund",
  "amount": 300100,
  "currency": "INR",
  "payment_id": "pay_FIKOnlyii5QGNx",
  "notes": {
    "comment": "Comment for refund"
  },
  "receipt": null,
  "acquirer_data": {
    "arn": "10000000000000"
  },
  "created_at": 1597078124,
  "batch_id": null,
  "status": "processed",
  "speed_processed": "normal",
  "speed_requested": "optimum"
}
```
-------------------------------------------------------------------------------------------------------

### Fetch all refunds
```php
$options = array("count" => 2);

$api->refund->all($options);
```

**Parameters:**

| Name  | Type      | Description                                      |
|-------|-----------|--------------------------------------------------|
| from  | timestamp | timestamp after which the payments were created  |
| to    | timestamp | timestamp before which the payments were created |
| count | integer   | number of payments to fetch (default: 10)        |
| skip  | integer   | number of payments to be skipped (default: 0)    |

**Response:**
```json
{
  "entity": "collection",
  "count": 2,
  "items": [
    {
      "id": "rfnd_FFX6AnnIN3puqW",
      "entity": "refund",
      "amount": 88800,
      "currency": "INR",
      "payment_id": "pay_FFX5FdEYx8jPwA",
      "notes": {
        "comment": "Issuing an instant refund"
      },
      "receipt": null,
      "acquirer_data": {},
      "created_at": 1594982363,
      "batch_id": null,
      "status": "processed",
      "speed_processed": "optimum",
      "speed_requested": "optimum"
    }
  ]
}
```
-------------------------------------------------------------------------------------------------------

### Fetch particular refund
```php
$api->refund->fetch($refundId);
```

**Parameters:**

| Name          | Type        | Description                                 |
|---------------|-------------|---------------------------------------------|
|  refundId*   | string      | The id of the refund to be fetched           |

**Response:**
```json
{
  "id": "rfnd_EqWThTE7dd7utf",
  "entity": "refund",
  "amount": 6000,
  "currency": "INR",
  "payment_id": "pay_EpkFDYRirena0f",
  "notes": {
    "comment": "Issuing an instant refund"
  },
  "receipt": null,
  "acquirer_data": {
    "arn": "10000000000000"
  },
  "created_at": 1589521675,
  "batch_id": null,
  "status": "processed",
  "speed_processed": "optimum",
  "speed_requested": "optimum"
}
```
-------------------------------------------------------------------------------------------------------

### Update the refund
```php
$api->refund->fetch($refundId)->edit(array('notes'=> array('notes_key_1'=>'Beam me up Scotty.', 'notes_key_2'=>'Engage')));
```

**Parameters:**

| Name  | Type      | Description                                      |
|-------|-----------|--------------------------------------------------|
| refundId*   | string    | The id of the refund to be fetched     |
| notes* | array  | A key-value pair                                 |

**Response:**
```json
{
  "id": "rfnd_FP8DDKxqJif6ca",
  "entity": "refund",
  "amount": 300100,
  "currency": "INR",
  "payment_id": "pay_FIKOnlyii5QGNx",
  "notes": {
    "notes_key_1": "Beam me up Scotty.",
    "notes_key_2": "Engage"
  },
  "receipt": null,
  "acquirer_data": {
    "arn": "10000000000000"
  },
  "created_at": 1597078124,
  "batch_id": null,
  "status": "processed",
  "speed_processed": "normal",
  "speed_requested": "optimum"
}
```
-------------------------------------------------------------------------------------------------------

**PN: * indicates mandatory fields**
<br>
<br>
**For reference click [here](https://razorpay.com/docs/api/refunds/)**