Callback

Callback (ქოლბექი) არის ასინქრონული, სერვერებს შორის შეტყობინება, რომელიც იგზავნება გადახდების სისტემიდან თქვენს მიერ მითითებულ callback_url-ზე. მისი მიზანია, საიმედოდ აცნობოს თქვენს სისტემას ტრანზაქციის საბოლოო სტატუსი (მაგ., წარმატებული გადახდა, თანხის დაბრუნება).

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

შეტყობინების მიღებისას, თქვენმა სისტემამ უნდა გადაამოწმოს ციფრული ხელმოწერა, რათა დარწმუნდეს, რომ ინფორმაცია ნამდვილი და უცვლელია. ამის შემდეგ, წარმატებული მიღების დასადასტურებლად, სისტემამ უნდა დააბრუნოს HTTP 200 OK პასუხი.

მოთხოვნის აღწერა (შემომავალი Callback)

გადახდის სისტემა გამოაგზავნის HTTP POST მოთხოვნას callback_url-ზე, რომელიც თქვენ მიუთითეთ წინასწარი შეკვეთის (Pre-order) შექმნისას. ეს მოთხოვნა შეიცავს ტრანზაქციის საბოლოო სტატუსსა და დეტალებს.

Headers

Header	ტიპი	აღწერა
Callback-Signature	String	არასავალდებულო, მაგრამ რეკომენდებული. Base64-ით კოდირებული ხელმოწერა, რომელიც გენერირებულია მოთხოვნის საწყისი ტანის (raw request body) ბანკის პირადი გასაღებით დაშიფვრის შედეგად, SHA256withRSA ალგორითმის გამოყენებით. თქვენ უნდა გადაამოწმოთ ეს ხელმოწერა მოწოდებული საჯარო გასაღებით, რათა დარწმუნდეთ Callback-ის ავთენტურობასა და მონაცემთა მთლიანობაში.

Request Body

პარამეტრი	ტიპი	აღწერა
event	String	შეტყობინების ტიპი. გადახდის სტატუსის განახლებისთვის, მნიშვნელობა ყოველთვის არის link_payment.
zoned_request_time	String	დროის შტამპი, რომელიც აღნიშნავს, როდის გაიგზავნა Callback-ი, UTC ფორმატში (მაგ., "YYYY-MM-DDTHH:MM:SS.ssssssZ").
body	Object	ობიექტი, რომელიც შეიცავს შეკვეთისა და გადახდის დეტალურ მონაცემებს, "წინასწარი შეკვეთის დეტალების მიღების" მეთოდის პასუხის მსგავსად.

REQUEST

{
    "event": "link_payment",
    "zoned_request_time": "2026-04-22T11:09:31.458943Z",
    "body": {
        "pre_order_id": "0873d2db-5bf5-4845-91a3-f25e65f4749d",
        "zoned_create_date": "2026-04-21T11:09:31.458943Z",
        "zoned_expire_date": "2026-04-22T11:09:31.458943Z",
        "pre_order_status": {
            "key": "performed",
            "value": "Performed"
        },
        "transaction_status": {
            "key": "refunded_partially",
            "value": "Partially refunded"
        },
        "payment_detail": {
            "transfer_method": {
                "key": "card",
                "value": "Card Payment"
            },
            "transaction_id": "611115529598",
            "payer_identifier": "411634***8449",
            "order_id": "d300e690-83ba-4f88-afbf-3d3fdaeda95b"
        },
        "purchase_units": {
            "request_amount": "1.0",
            "transfer_amount": "0.4",
            "refund_amount": "0.6",
            "currency_code": "GEL",
            "items": null
        },
        "lang": "ka",
        "invoice_payment_url": "https://link.bog.ge/HnisFqRnzJz",
        "description": "string",
        "external_order_id": "id123"
    }
}