Skip to main content

რეკურენტული გადახდები

რეკურენტული გადახდები საშუალებას გაძლევთ, შეინახოთ მომხმარებლის მონაცემები და შეასრულოთ გადახდები მომხმარებლის მონაწილეობის გარეშე. რეკურენტული გადახდების შესასრულებლად საჭიროა წარმატებული გადახდის იდენტიფიკატორი (order_id), რომლის მისაღებად, შესაძლებელია, მინიმუმ, 10-თეთრიანი გადახდის შესრულება, ხოლო შემდეგ, ამ თანხის დაბრუნების ოპერაცია. მეთოდის მიერ დაბრუნებულ სტატუსში (status ატრიბუტი), უმეტეს შემთხვევაში, იქნება in_progress მნიშვნელობა, რადგან მეთოდი სინქრონულად აბრუნებს პასუხს, ხოლო გადახდის პროცესს პასუხის დაბრუნების შემდგომ იწყებს. მიმდინარე სტატუსის გასაგებად უნდა გამოიყენოთ გადახდის დეტალების მიღების მეთოდი.

note

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

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

Content-Typerequiredapplication/json

ყოველთვის გადაეცემა „application/json“ მნიშვნელობა.

AuthorizationrequiredBearer token

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

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

order_idrequiredstring

მოცემული მომხმარებლის მიერ წარმატებით დასრულებული გადახდის იდენტიფიკატორი.

amountrequiredobject

თანხის ობიექტი.

currency_coderequiredGEL

გადახდის ვალუტა.

valuerequirednumber

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

shop_order_idoptionalstring

გადახდის იდენტიფიკატორი ონლაინ მაღაზიის სისტემიდან (მაგალითად: შესყიდვების კალათის იდენტიფიკატორი).

purchase_descriptionoptionalstring

შესყიდული პროდუქტის დასახელება (აღწერა რომელიც მომხმარებელს ამონაწერში გამოუჩნდება)
POST /api/v1/checkout/payment/subscription
Content-Type: application/json
Authorization: Bearer <jwt_token>
{
  "order_id": "<order_id>",
  "amount": {
    "currency_code": "GEL",
    "value": "16.45"
  },
  "shop_order_id": "your_shop_order_id",
  "purchase_description": "test_product"
}

Response​

statusstring

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

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

payment_hashstring

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

order_idstring

მიმდინარე გადახდის იდენტიფიკატორი.
{
  "status": "success",
  "payment_hash": "<payment_hash>",
  "order_id": "<order_id>"
}