მეთოდის საშუალებით, ბიზნესს აქვს შესაძლებლობა, მიიღოს დეტალური ინფორმაცია ონლაინ გადახდის შესახებ, მისი იდენტიფიკატორის მიხედვით. ### Header-ის პარამეტრები - `Authorization` — Basic , required გადაეცემა `Bearer ` მნიშვნელობა, სადაც `jwt_token` არის აუტენტიფიკაციის მეთოდის Response-ის access_token პარამეტრში დაბრუნებული მნიშვნელობა. ### Path პარამეტრები - `order_id` — string, required შეკვეთის იდენტიფიკატორი, რომელიც ონლაინ მაღაზიას უბრუნდება შეკვეთის მოთხოვნის Response-ში. **CURL** ```bash curl -X GET 'https://api-sandbox.bog.ge/payments/v1/receipt/:order_id' \ -H 'Authorization: Bearer ' ``` ## Response - `order_id` — string ონლაინ გადახდის იდენტიფიკატორი. - `industry` — string ბიზნესის ინდუსტრია, რომელიც მისი რეგისტრაციის დროს განისაზღვრება. - `capture` — string ავტორიზაციის მეთოდი. ყოველთვის - `automatic`. ტრანზაქციის ტიპი ორი შესაძლო მნიშვნელობით: - `automatic` - სტანდარტული ორდერი - `manual` - პრეავტორიზაციის ორდერი - `external_order_id` — string გადახდის იდენტიფიკატორი ბიზნესის სისტემიდან. გადმოცემული მნიშვნელობის პირველი 25 სიმბოლო აისახება გადახდის დანიშნულებაში, როგორც გადამხდელის ამონაწერში, ისე კომპანიის ანგარიშზე თანხის ჩარიცხვის დანიშნულებაში. - `client` — object ბიზნესის ინფორმაცია. - `client.id` — string ბიზნესის იდენტიფიკატორი ბანკის სისტემაში. - `client.brand_ka` — string ბიზნესის ქართული დასახელება. - `client.brand_en` — string ბიზნესის ინგლისური დასახელება. - `client.url` — string ბიზნესის ვებგვერდის მისამართი. - `zoned_create_date` — string შეკვეთის შექმნის თარიღი მსოფლიო კოორდინირებული დროით ( UTC), "YYYY-MM-DDTHH:MM:SS.ssssssZ" ფორმატში. - `zoned_expire_date` — string შეკვეთის ვადის გასვლის თარიღი მსოფლიო კოორდინირებული დროით (UTC), "YYYY-MM-DDTHH:MM:SS.ssssssZ" ფორმატში. - `order_status` — object შეკვეთის სტატუსი. - `order_status.key` — string სტატუსი იღებს შემდეგ მნიშვნელობებს: - `created` - გადახდის მოთხოვნა შექმნილია - `processing` - გადახდა მუშავდება - `completed` - გადახდის პროცესი დასრულდა წარმატებით - `rejected` - გადახდის პროცესი დასრულდა წარუმატებლად - `refund_requested` - მოთხოვნილია თანხის დაბრუნება - `refunded` - გადახდის თანხა დაბრუნებულია - `refunded_partially` - გადახდის თანხა ნაწილობრივ დაბრუნებულია - `auth_requested` - პრეავტორიზირებული გადახდა მოთხოვნილია - `blocked` - პრეავტორიზირებული გადახდის პროცესი დასრულდა წარმატებით, თუმცა თანხა ჯერ დაბლოკილია და ელოდება დადასტურებას - `partial_completed` - პრეავტორიზირებული გადახდა ნაწილობრივ თანხაზე წარმატებით დადასტურდა - `order_status.value` — string აღწერა. - `buyer` — object მყიდველის ინფორმაცია. - `buyer.full_name` — string მყიდველის სრული სახელი. - `buyer.email` — string მყიდველის ელ. ფოსტის მისამართი. - `buyer.phone_number` — string მყიდველის ტელეფონის ნომერი. - `purchase_units` — object ინფორმაცია შესყიდული პროდუქციის შესახებ. - `purchase_units.request_amount` — string შეკვეთის მოთხოვნილი თანხა. - `purchase_units.transfer_amount` — string შეკვეთის დამუშავებული თანხა. - `purchase_units.refund_amount` — string დაბრუნებული თანხა. - `purchase_units.currency_code` — string ვალუტა. - `purchase_units.items` — array შეძენილი პროდუქტების/სერვისების მასივი. - `purchase_units.items[].external_item_id` — string პროდუქტის/სერვისის იდენტიფიკატორი ბიზნესის სისტემაში. - `purchase_units.items[].description` — string პროდუქტის/სერვისის დასახელება (აღწერა). - `purchase_units.items[].quantity` — string თითოეული პროდუქტის/სერვისის რაოდენობა (მოცულობა). - `purchase_units.items[].unit_price` — string პროდუქტის/სერვისის ერთეულის ფასი. - `purchase_units.items[].unit_discount_price` — string აქციით გადახდის შემთხვევაში, შესყიდული პროდუქტის/სერვისის ერთეულის დაკლებული თანხის მოცულობა. - `purchase_units.items[].vat` — string პროდუქტის/სერვისის დამატებული ღირებულების გადასახადი (დღგ). - `purchase_units.items[].vat_percent` — string პროდუქტის/სერვისის დამატებული ღირებულების გადასახადის (დღგ) პროცენტი. - `purchase_units.items[].total_price` — string მთლიანი თანხა. - `purchase_units.items[].package_code` — string პროდუქტის კოდი. - `purchase_units.items[].tin` — string საგადასახადო საიდენტიფიკაციო ნომერი (TIN). - `purchase_units.items[].pinfl` — string გადამხდელის კოდი (PINFL). - `purchase_units.basket[].product_discount_id` — string პროდუქტის ფასდაკლების იდენტიფიკატორი. თუ მოწოდებული მნიშვნელობით ბანკში დარეგისტრირებულია ფასდაკლების აქცია, ფასდაკლების პირობების გათვალისწინებით, შეკვეთაზე გავრცელდება შესაბამისი აქცია. - `redirect_links` — object ბიზნესის ვებგვერდები, რომლებზეც შესაძლოა გადამისამართდეს მომხმარებელი ონლაინ გადახდის სისტემიდან, ოპერაციის დასრულების შემდეგ. - `redirect_links.fail` — string ვებმისამართი ოპერაციის წარუმატებლად დასრულების შემთხვევაში. - `redirect_links.success` — string ვებმისამართი ოპერაციის წარმატებით დასრულების შემთხვევაში. - `payment_detail` — object გადახდის დეტალები. - `payment_detail.transfer_method` — object გადახდის მეთოდი. - `payment_detail.transfer_method.key` — string გადახდის მეთოდი იღებს შემდეგ მნიშვნელობებს: - `card` - საბანკო ბარათით გადახდა :::note **Sandbox სატესტო გარემოში ამ ეტაპზე ხელმისაწვდომია მხოლოდ საბარათე გადახდის მეთოდი.**
სხვა გადახდის მეთოდებიც მალე დაემატება. ::: - `google_pay` - Google Pay-ით გადახდა - `apple_pay` - Apple Pay-ით გადახდა - `bog_p2p` - საქართველოს ბანკის, ინტერნეტ ან მობაილ ბანკის მომხმარებლით გადარიცხვა - `bog_loyalty` - საქართველოს ბანკის ქულებით MR/Plus გადახდა - `bnpl` - ნაწილ-ნაწილით გადახდა - `bog_loan` - სტანდარტული საბანკო განვადება. - `payment_detail.transfer_method.value` — string აღწერა. - `payment_detail.transaction_id` — string ტრანზაქციის იდენტიფიკატორი. - `payment_detail.auth_code` — string გადახდის ავტორიზაციის იდენტიფიკატორი. მნიშვნელობა ასევე აისახება კომპანიის ანგარიშზე ანგარიშსწორების ამონაწერში. - `payment_detail.payer_identifier` — string გადამხდელის იდენტიფიკატორი, transfer_method-ის მიხედვით იღებს სხვა და სხვა მნიშვნელობას: - `card`/`google_pay` – ბრუნდება ბარათის დაშიფრული ნომერი (PAN) - `apple_pay` – ბრუნდება Apple-ის მიერ მინიჭებული ბარათის ნომერი, რომელიც უნიკალურია ყველა მოწყობილობისთვის - `bog_p2p`/`bog_loyalty` – ბრუნდება ანგარიშის სახელი - `bog_loan`/`bnpl` – ბრუნდება მომხმარებლის სახელი და გვარის პირველი ასო. - `payment_detail.payment_option` — string გადახდის გზა. შესაძლებელია დაბრუნდეს შემდეგი მნიშვნელობები: - `direct_debit` - ბარათით გადახდა - `recurrent` - დამახსოვრებული ბარათით გადახდა - `subscription` - დამახსოვრებული ბარათით ავტომატური ჩამოჭრა. - `payment_detail.card_type` — string იმ ბარათის ტიპი, რომლითაც მოხდა გადახდა. პარამეტრი მნიშვნელობას იღებს საბარათე გადახდის დროს: - `amex` - American Express - `mc` - Mastercard - `visa` - Visa. - `payment_detail.card_expiry_date` — string იმ ბარათის ვადის გასვლის თარიღი (თვე/წელი), რომლითაც მოხდა გადახდა. პარამეტრი მნიშვნელობას იღებს საბარათე გადახდის დროს. - `payment_detail.request_account_tag` — string ელ.კომერციის POS ტერმინალის შეკვეთაში მოთხოვნილი იდენტიფიკატორი - `payment_detail.transfer_account_tag` — string ელ.კომერციის იმ POS ტერმინალის იდენტიფიკატორი, რომელზეც შესრულდა გადახდა. - `payment_detail.saved_card_type` — string დამახსოვრებული ბარათის ტიპი. შესაძლო მნიშვნელობებია: - `recurrent` - ბარათი დამახსოვრებულია კლიენტის მიერ ინცირებული მომავალი გადახდისთვის. - `subscription` - ბარათი დამახსოვრებულია ავტომატური გადახდებისთვის ფიქსირებული თანხითა და დეტალებით. - `payment_detail.parent_order_id` — string თუ გადახდა მოხდა დამახსოვრებული ბარათით, აღნიშნულ ველში მითითებულია დამახსოვრებული ბარათის შეკვეთის იდენტიფიკატორი. - `payment_detail.code` — string გადახდის Response კოდი. - `payment_detail.code_description` — string გადახდის Response კოდის აღწერა. - `payment_detail.auth_code` — string საბარათე, Google Pay-ით ან Apple Pay-ით გადახდის ავტორიზაციის კოდი. - `discount` — object ინფორმაცია ფასდაკლების შესახებ, რომელიც გავრცელდა გადახდაზე - `discount.bank_discount_amount` — string ბანკის მიერ გავრცელებული ფასდაკლების თანხა - `discount.bank_discount_desc` — string ბანკის მიერ გავრცელებული ფასდაკლების აღწერა - `discount.system_discount_amount` — string საბარათე სისტემის მიერ გავრცელებული ფასდაკლების თანხა - `discount.system_discount_desc` — string საბარათე სისტემის მიერ გავრცელებული ფასდაკლების აღწერა - `discount.discounted_amount` — string თანხა ფასდაკლების შემდეგ - `discount.original_order_amount` — string საწყისი თანხა - `actions` — array შეკვეთასთან დაკავშირებული ქმედებების სია. - `actions[].action_id` — string ქმედების იდენტიფიკატორი. - `actions[].request_channel` — string წყარო, რომლიდანაც მოხდა ქმედების ინიციარება: - `public_api` - ონლაინ გადახდების API - `business_manager` - ბიზნეს მენეჯერის გვერდი - `support` - საქართველოს ბანკის შიდა სისტემა. - `actions[].action` — string ქმედების ტიპი: - `authorize` - პრეავტორიზირებული გადახდის დადასტურება - `partial_authorize` - პრეავტორიზირებული გადახდის დადასტურება არასრულ თანხაზე - `cancel_authorize` - პრეავტორიზირებული გადახდის უარყოფა - `refund` - თანხის დაბრუნება - `partial_refund` - თანხის ნაწილობრივი დაბრუნება. - `actions[].status` — string ქმედების სტატუსი: - `completed` - ქმედება დასრულდა წარმატებით - `rejected` - ქმედება დასრულდა წარმუმატებლად - `actions[].code` — string მოქმედების response კოდი. მოქმედების Response კოდების სია იხ. [აქ](../response-codes#მოქმედების-response-კოდები). - `actions[].code_description` — string მოქმედების response კოდის აღწერა. - `actions[].zoned_action_date` — string ქმედების ინიცირების თარიღი მსოფლიო კოორდინირებული დროით (UTC), "YYYY-MM-DDTHH:MM:SS.ssssssZ" ფორმატში. - `actions[].amount` — string თანხის მოცულობა, რომელზეც განხორციელდა ქმედება. - `lang` — string ონლაინ გადახდების გვერდზე გადამისამართების შემდეგ, რა ენის ინტერფეისი დახვდება მომხმარებელს. იღებს ორ მნიშვნელობას: - `ka` - ქართული - `en` - ინგლისური. - `reject_reason` — string გადახდის წარუმატებლად დასრულების მიზეზი. პარამეტრი მნიშვნელობას იღებს მხოლოდ მაშინ, თუ შეკვეთა წარუმატებლად დასრულდა ("order_status": "rejected"). იღებს შემდეგ მნიშვნელობებს: - `expiration` - შეკვეთას გაუვიდა ვადა - `unknown` - დაუდგენელი მიზეზი. - `გადახდის Response კოდის აღწერა` - ბარათით, Google pay-ით ან Apple pay-ით ინიცირებული გადახდების უარყოფის მიზეზი. Response კოდების სია იხილეთ [აქ](https://api.bog.ge/docs/docs/payments/response-codes). **RESPONSE** ```json { "order_id": "a767a276-cddd-43ec-9db3-9f9b39eee02d", "industry": "ecommerce", "capture": "automatic", "external_order_id": "123456", "client": { "id": "10000", "brand_ka": "საქართველოს ბანკი", "brand_en": "BOG", "url": "https://api.bog.ge" }, "create_date": "2022-11-01T13:19:43.021178", "zoned_create_date": "2022-11-01T13:19:43.021178Z", "expire_date": "2022-11-01T13:39:43.021178", "zoned_expire_date": "2022-11-01T13:39:43.021178Z", "order_status": { "key": "refunded", "value": "დაბრუნებული" }, "buyer": { "full_name": "John Doe", "email": "johndoe@gmail.com", "phone_number": "+995555000000" }, "purchase_units": { "request_amount": "100.5", "transfer_amount": "0.0", "refund_amount": "100.5", "currency_code": "GEL", "items": [ { "external_item_id": "id_1", "description": "product 1", "quantity": "1", "unit_price": "25.35", "unit_discount_price": "0", "vat": "0", "vat_percent": "0", "total_price": "25.35", "package_code": "A000123", "tin": null, "pinfl": null, "product_discount_id": "BF222R5" } ] }, "redirect_links": { "success": "https://payment.bog.ge/receipt?order_id=a767a276-cddd-43ec-9db3-9f9b39eee02d", "fail": "https://payment.bog.ge/receipt?order_id=a767a276-cddd-43ec-9db3-9f9b39eee02d" }, "payment_detail": { "transfer_method": { "key": "card", "value": "ბარათით გადახდა" }, "code": "100", "code_description": "Successful payment", "transaction_id": "230513868679", "payer_identifier": "548888xxxxxx9893", "payment_option": "direct_debit", "card_type": "mc", "card_expiry_date": "03/24", "request_account_tag": "1212", "transfer_account_tag": "gev2", "saved_card_type": "recurrent", "parent_order_id": "8d52130d-cb1b-45ea-b048-0f040a44e2a3", "pg_trx_id": "K4T2XMAZ9EBVQ3WN", "auth_code": "483921" }, "discount": { "bank_discount_amount": "string", "bank_discount_desc": "string", "discounted_amount": "string", "original_order_amount": "string", "system_discount_amount": "string", "system_discount_desc": "string" }, "actions": [ { "action_id": "b70968ca-eda9-47ae-8811-26fd1ab733f8", "request_channel": "public_api", "action": "authorize", "status": "completed", "action_date": "2022-11-28T13:42:40.668439", "zoned_action_date": "2022-11-28T13:42:40.668439Z", "amount": "100.5", "code": null, "code_description": null }, { "action_id": "a89b872a-9700-4025-b3fb-047cbba7a5e6", "request_channel": "business_manager", "action": "refund", "status": "completed", "action_date": "2022-11-28T13:58:03.427939", "zoned_action_date": "2022-11-28T13:58:03.427939Z", "amount": "100.5", "code": null, "code_description": null } ], "disputes": null, "split": null, "lang": "ka", "reject_reason": null } ```