დამახსოვრებული ბარათით ავტომატური ჩამოჭრა

მეთოდის საშუალებით, ბიზნესს შეუძლია მომხმარებელს თანხა ჩამოაჭრას მისი მონაწილეობის გარეშე. მეთოდის გამოყენება მიზანშეწონილია, თუ მომხმარებელს რომელიმე წინა წარმატებული საბარათე გადახდის დროს დამახსოვრებული ჰქონდა ბარათი ავტომატური ჩამოჭრისთვის.

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 პარამეტრები

parent_order_idrequiredstring

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

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

callback_urloptionalstring

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

external_order_idoptionalstring

გადახდის იდენტიფიკატორი ბიზნესის სისტემიდან (მაგალითად: შესყიდვების კალათის იდენტიფიკატორი).
არ გადმოცემის შემთხვევაში, გამოიყენება parent_order_id-ის შესაბამისი შეკვეთის შექმნისას გადმოცემული მნიშვნელობა.

note

რაც შეეხება დანარჩენ პარამეტრებს (თანხა, ვალუტა, მყიდველის ინფორმაცია და სხვ.), რომლებიც საჭიროა შეკვეთის მოთხოვნისთვის, სისტემა ავტომატურად გამოიყენებს parent_order_id-ის შესაბამისი შეკვეთის შექმნისას გადმოცემულ მნიშვნელობებს.

CURL

curl -X POST 'https://api.bog.ge/payments/v1/ecommerce/orders/:parent_order_id/subscribe' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json'

Response

idstring

ონლაინ გადახდის იდენტიფიკატორი.

_linksobject

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

_links.details.hrefstring

გადახდის დეტალების მისამართი, რომლის გამოძახებითაც შეგიძლიათ, გაიგოთ ინფორმაცია ონლაინ გადახდის შესახებ.

RESPONSE

{
    "id": "{order_id}",
    "_links": {
        "details": {
            "href": "https://api.bog.ge/payments/v1/receipt/{order_id}"
        }
    }
}