Skip to main content

Pre-order-ის შექმნა

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

მეთოდი: POST /v1/preorder

Headers: იხ. Common Headers

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

callback_urlrequiredstring

HTTPS URL, რომელზეც ბანკის სერვერი აგზავნის ასინქრონულ შეტყობინებებს (callbacks) ოპერაციის საბოლოო სტატუსის შესახებ.

descriptionrequiredstring

შეკვეთის ან მომსახურების მოკლე აღწერა.

external_order_idoptionalstring

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

purchase_unitsrequiredobject

ობიექტი, რომელიც შეიცავს გადახდის თანხისა და ვალუტის დეტალებს.

purchase_units.currencyrequiredstring

ვალუტის სამასოიანი კოდი (მაგ., 'GEL').

purchase_units.total_amountrequirednumber

ტრანზაქციის სრული თანხა.

ttloptionalinteger

TTL3 - დრო წუთებში, რომლის განმავლობაშიც წინასწარი შეკვეთის (pre-order) ლინკი ვალიდურია. მინიმალური: 2 წუთი. მაქსიმალური: 1440 წუთი (24 საათი). Default: 15 წუთი.

curl --location 'https://api.bog.ge/payments/v1/pre-orders' \
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <JWT>' \
--data '{
  "callback_url": "https://example.com/callback",
  "description": "service fee",
  "external_order_id": "id123",
  "purchase_units": {
    "currency": "GEL",
    "total_amount": 1
  },
  "ttl": 1440
}'

Response​

idstring

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

_linksobject

რესურსთან დაკავშირებული ჰიპერმედია ბმულების კონტეინერი.

_links.payment_linkobject

ობიექტი, რომელიც შეიცავს URL მისამართს მომხმარებლის მიერ გადახდის დასასრულებლად.

_links.payment_link.hrefstring

სრული URL მისამართი, რომელიც ახდენს მომხმარებლის გადამისამართებას ბანკის დაცულ გადახდის გვერდზე.

{
    "id": "c0fb0f1d-7715-485a-b753-10cf148708e3",
    "_links": {
        "payment_link": {
            "href": "https://link.bog.ge/HnisFqRnzJz"
        }
    }
}