View as Markdown

გადახდების დეტალების მიღება ⚠️(Deprecated)

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

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

Content-Typerequiredapplication/json

AuthorizationrequiredBearer token

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

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

order_idrequiredstring

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

REQUEST

GET /api/v1/checkout/payment/{order_id}
Content-Type: application/json
Authorization: Bearer <jwt_token>

Response

statussuccess | error | in_progress

გადახდის სტატუსი. იღებს შემდეგ მნიშვნელობებს:

• success - გადახდის პროცესი დასრულდა წარმატებით.
• error - გადახდის პროცესი დასრულდა წარუმატებლად.
• in_progress - გადახდის პროცესი არაა დასრულებული და თუ ორდერის გენერაციიდან 1 საათში მომხმარებელი არ დაასრულებს ტრანზაქციას, ის ავტომატურად გაუქმდება და გადავა error სტატუსზე. ეს სტატუსი ენიჭება გადახდას, როდესაც მომხმარებელი გადამისამართდება ბანკის ონლაინ გადახდის ვებგვერდზე, ხოლო ცვლილება ხდება გადახდის წარმატებით ან წარუმატებლად დასრულების შემდეგ.

payment_hashstring

payment_hash - შეკვეთის მოთხოვნის დროს, გადახდების ონლაინ სისტემის მიერ დაგენერირებული გადახდის უნიკალური ჰეშირებული იდენტიფიკატორი.

ipay_payment_idstring

გადახდის იდენტიფიკატორი სისტემაში (ჩანს ასევე გადახდის ქვითარზე).

status_descriptionstring

დამატებითი ინფორმაცია სტატუსის შესახებ. მაგალითად, თუ status=error, აქ ეწერება შეცდომის აღწერა.

shop_order_idstring

მერჩანტის გადახდის იდენტიფიკატორი

payment_methodstring

გადახდის მეთოდი. შეიძლება მიიღოს შემდეგი მნიშვნელობები:

• BOG_CARD გადახდა შესრულებულია ავტორიზაციით.
• GC_CARD გადახდა შესრულებულია ბარათით.
• BOG_LOAN განვადებით ყიდვა.
• BOG_LOYALTY გადახდა შესრულებულია PLUS ან MR ქულებით.
• UNKNOWN ბრუნდება იმ შემთხვევაში, თუ ორდერის სტატუსი არის error ან in_progress.

card_typestring

თუ გადახდის ტიპი არის BOG_CARD ან GC_CARD, იწერება ბარათის ტიპი. დანარჩენ სხვა შემთხვევაში იწერება UNKNOWN. ბარათის ტიპი შეიძლება იყოს ქვემოთ მოცემულიდან ერთ-ერთი:

• MC - Mastercard
• VISA - Visa
• AMEX - American Express

panstring

ბარათის 16-ნიშნა ნომერი. ჩანს მხოლოდ პირველი 6 და ბოლო 4 ციფრი. დანარჩენი ციფრების ნაცვლად მითითებულია „*“. შევსებულია მხოლოდ მაშინ, თუ გადახდის სტატუსი არის success და payment_method არის GC_CARD.

transaction_idstring

Georgian Card-ში ტრანზაქციის იდენტიფიკატორი. შევსებულია მხოლოდ მაშინ, თუ გადახდის სტატუსი არის success და payment_method არის GC_CARD.

pre_auth_statusstring

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

• success - პრეავტორიზაცია დამოწმებულია და თანხა გადარიცხულია მერჩანტთან.
• in_progress - - მიმდინარეობს პრეავტორიზაცია. თანხა დაბლოკილია და შესაძლებელია დამოწმება და განბლოკვა.
• success_unblocked - პრეავტორიზაცია განბლოკილია. თანხა დაბრუნებულია მომხმარებლის ანგარიშზე და ჩანს ხელმისაწვდომ თანხებში.

BOG Payment

{
  "status": "success",
  "order_id": "{order_id}",
  "payment_hash": "{payment_hash}",
  "ipay_payment_id": "{ipay_payment_id}",
  "status_description": "PERFORMED",
  "shop_order_id": "123456789",
  "payment_method": "BOG_CARD",
  "card_type": "MC",
}

Card Payment

{
  "status": "success",
  "order_id": "{order_id}",
  "payment_hash": "{payment_hash}",
  "ipay_payment_id": "{ipay_payment_id}",
  "status_description": "PERFORMED",
  "shop_order_id": "123456789",
  "payment_method": "GC_CARD",
  "card_type": "MC",
  "pan": "9000XXXXXXXX0000001",
  "transaction_id": "{transaction_id}"
}

Pre-auth Payment

{
  "status": "success",
  "order_id": "{order_id}",
  "pre_auth_status": "success",
  "payment_hash": "{payment_hash}",
  "ipay_payment_id": "{ipay_payment_id}",
  "status_description": "PERFORMED",
  "shop_order_id": "123456789",
  "payment_method": "GC_CARD",
  "card_type": "MC",
  "pan": "9000XXXXXXXX0000001",
  "transaction_id": "{transaction_id}"
}