ამ მეთოდის საშუალებით ბიზნესს შეუძლია სრულად ან ნაწილობრივ დააბრუნოს შეკვეთისას გადახდილი თანხა. ბარათით, Apple Pay-ით, Google Pay-ით, BOG ავტორიზაციითა და ქულებით შესრულებული გადახდების უკან დაბრუნება შესაძლებელია როგორც სრულად, ისე ნაწილობრივ. ნაწილობრივი დაბრუნების მეთოდის გამოძახება დასაშვებია მანამ, სანამ გადახდილი თანხა სრულად არ დაბრუნდება.

### Header-ის პარამეტრები

- `Content-Type` — application/json, required

- `Authorization` — Basic <base64>, required

  გადაეცემა `Bearer <jwt_token>`  მნიშვნელობა, სადაც `jwt_token` არის აუტენტიფიკაციის მეთოდის Response-ის access_token პარამეტრში დაბრუნებული მნიშვნელობა.

- `Idempotency-Key` — UUID v4

  Idempotency-Key პარამეტრი უნდა იყოს უნიკალური ყველა ახალი API რექვესთისთვის.
  იმავე API-ზე Idempotency-Key-ის განმეორებით გამოყენებისას სერვერი დააბრუნებს იმავე სტატუს კოდსა და body-ს, რაც თავდაპირველი მოთხოვნისას.
  ეს ფუნქცია განსაკუთრებით სასარგებლოა თანმიმდევრული შედეგის უზრუნველსაყოფად, როდესაც საქმე გვაქვს ქსელური პრობლემებითა ან ხელახალი ცდებით გამოწვეულ დუბლირებულ მოთხოვნებთან.

### Path პარამეტრები

- `order_id` — string, required

  შეკვეთის იდენტიფიკატორი, რომელიც ონლაინ მაღაზიას უბრუნდება შეკვეთის მოთხოვნის Response-ში.

### Body-ს პარამეტრები

- `amount` — number

  დასაბრუნებელი თანხა. გადმოცემა აუცილებელია, თუ თანხა ბრუნდება ნაწილობრივად. პარამეტრის არ გადმოცემის შემთხვევაში, თანხა სრულად დაბრუნდება. მნიშვნელობა არ შეიძლება იყოს დამუშავებულ თანხაზე (transfer_amount) მეტი.

**CURL**

```bash
curl -X POST 'https://api.bog.ge/payments/v1/payment/refund/:order_id' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
--data-raw '{
    "amount": "10.5"
}'
```

### Response

- `key` — string

  API მოთხოვნის სტატუსის იდენტიფიკატორი.

- `message` — string

  API მოთხოვნის სტატუსის აღწერა.

- `action_id` — string

  ქმედების იდენტიფიკატორი.

**RESPONSE**

```json
{
    "key": "request_received",
    "message": "Refund request received",
    "action_id": "5b666901-eb05-4f83-abeb-8311e175f337"
}
```
