Skip to main content

თანხის დაბრუნება

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

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

Content-Typerequiredapplication/json

AuthorizationrequiredBasic <base64>

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

Idempotency-KeyoptionalUUID v4

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

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

order_idrequiredstring

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

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

amountoptionalnumber

დასაბრუნებელი თანხა. გადმოცემა აუცილებელია, თუ თანხა ბრუნდება ნაწილობრივად (საბარათე, Apple Pay-ით ან Google Pay-ით გადახდის შემთხვევაში). პარამეტრის არ გადმოცემის შემთხვევაში, თანხა სრულად დაბრუნდება. მნიშვნელობა არ შეიძლება იყოს დამუშავებულ თანხაზე (transfer_amount) მეტი.
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​

keystring

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

messagestring

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

action_idstring

ქმედების იდენტიფიკატორი.
{
    "key": "request_received",
    "message": "Refund request received",
    "action_id": "5b666901-eb05-4f83-abeb-8311e175f337"
}