SPACE სერვისების აღწერა ონლაინ განვადების

ინტეგრაციისთვის

თარიღი ვერსია ავტორი აღწერა

12/12/2018 V01 დავით ბუაჩიძე დოკუმენტის შექმნა

20/12/2018 V02 დავით ბუაჩიძე დოკუმენტში შესწორებების შეტანა

05/03/2019 V04 დავით ბუაჩიძე დაემატა:

1. მაღაზიის საიტზე უკან დაბრუნება

2. მაღაზიის საიტზე ჩასაშენებელი QR

16/04/2019 V05 დავით ბუაჩიძე დაემატა: InstalmentCancellationApplication

24/04/2019 V06 დავით ბუაჩიძე დაემატა უმნიშველო ცვლილებები.

შინაარსი
CreateQr.....................................................................................................................................................................3
CreateQr Request:..................................................................................................................................................3
CreateQr Response................................................................................................................................................4
CreateQr გამოძახების ნიმუში:..........................................................................................................................4
CreateQr -QR კოდის ნიმუში:..............................................................................................................................6
Checkstatus................................................................................................................................................................7
Checkstatus Requet:...............................................................................................................................................7
Checkstatus Response:...........................................................................................................................................7
Checkstatus გამოძახების ნიმუში:......................................................................................................................8
განვადების გაუქმების განაცხადის რეგისტრაციის მეთოდი - InstalmentCancellationApplication..............9
Requet.................................................................................................................................................................... 9
Response................................................................................................................................................................9
InstalmentCancellationApplication გამოძახების ნიმუში:...............................................................................10

Davit Buachidze 1/9

481101344.docx
 CreateQr
CreateQr- მეთოდი გამოიყენება SPACE სისტემაში განვადების QR კოდის გენერაციისთვის.

გამოძახების მისამართი:
სატესტო გარემო: https://testapi.spacebank.ge/api/v1/qr/create
რეალური გარემო:
Method: POST
Content-Type: application/json

CreateQr Request:

გადაეცემა „Data“ ობიექტი:

„Data“ ობიექტისთვის გადასაცემი პარამეტრები:

Property Name Data Mand Description

Type atory
MerchantName Y მერჩანტის დასახელება (უნდა ემთხვეოდეს SPACE-ს
სისტემაში გაწერილ მნიშვნელობას.
PhoneNumber N კლიენტის ტელეფონის ნომრი.
GrandTotalAmount N უნდა იყოს პროდუქტების მასივში მოყვანილი
პროდუქტების ღირებულების ჯამი (მათ შორის
ტრანსპორტირების თანხაც),
DiscountAmount N ჯამური ფასდაკლება (ვაუჩერი + პროცენტული),
TotalAmount Y თანხა რომელზეც უნდა გაკეთდეს განვადება
(GrandTotalAmount - DiscountAmount)
OrderId Y განაცხადის იდენტიფიკატორი მერჩანტის სისტემაში
Type Y ყოველთვის იქნება 1-ის ტოლი, განსაზღვრავ QR ტიპს
Products Products N შესაძენი ნვთების სია კალათის მიხედვით (მათ შორის
ტრანსპორტირების თანხაც), ფასები მოყვანილია
ფასდაკლების გარეშე.
Secret Y სფეისის მიერ მერჩანტისთვის მიწოდებული საიდუმლო
გასაღები. მუდმივია ყველა განაცხადისთვის.
returnUrl N მერჩანტის მიერ მოწოდებული მისამართი, რომელზეც
დაბრუნდება სფეისი საიტი QR კოდის დასკანირების
შემდეგ.

“Products” ობიექტისთვის გადასაცემი პარამეტრები:

Property Name Data Mand Description

Type atory
Title Y ნივთის დასახელება ან მომსახურების დასახელება
Model N თუ მოდელი ცალკე არ არის მაღაზიის სისტემაში, ეს

Davit Buachidze 2/9

481101344.docx
 პარამეტრი რჩება ცარიელი და ზედა პარამეტრში
მოგვეწოდება დასახელებასთან ერთად.
Quantity Y ერთი დასახელების ქვეშ არსებული ნივთების რაოდენობა
Amount Y შესაძენი ნივთის ერთეულის ფასი
ImageUrl Y შესაძენი ნივთის სურათის URL მერჩანტის საიტზე.

CreateQr Response
CreateQr პოსტის წარმატებით დასრულების შემთხვევაში, მეთოდი აბრუნებს “data” და „status“
ობიექტს:

დაბრუნებული „data“ ობიექტის პარამეტრები:

Property Name Data Man Description

Type d
atory
qrCodeId Y სფეისში შექმნილი ჩანაწერის id
orderId Y მერჩანტის მოწოდებული ორდერის id
redirectUrl Y SPACE-ის ვებ გვერდის ლინკი, რომელზეც უნდა
გადამისამართდეს კლიენტი და რომელზეც იქნება
გამოსახული QR კოდი განვადების განაცხადის
ინიცირებისთვის.
qrCodeViewUrl ბრუნდება მხოლდ QR-ის სურათი და შესაძლებელია
მერჩანტის საიტზე ჩაშენება.

დაბრუნებული „status“ ობიექტის პარამეტრები:

Property Name Data Mand Description

Type atory
code code Y განსაზღვრავს მოთხოვნის წარმატებით მიღების სტატუს.
message N განმარტავს მოთხოვნის შეცდომაზე გასვლის მიზეზს.

Code-ის განმარტება:

0 დაფიქსირდა შეცდომა
1 ოპერაცია წარმატებით განხორციელდა
1503  დუბლიკატი შეკვეთის იდენტიფიკატორი

1504 არასწორი თანხა

1505 არასწორი გასაღები
1506 არასწორი სახელი

CreateQr გამოძახების ნიმუში:

{  
   "Data":{  

Davit Buachidze 3/9

481101344.docx
      "MerchantName":"Megamall",
      "PhoneNumber":"599112233",
      "GrandTotalAmount":1830,
      "DiscountAmount": 50,
      "TotalAmount":1780,
      "OrderId":"20181213V02",
      "Type":1,
      "returnUrl": " https://www.youtube.com/",
      "Products":[  
         {  
            "Title":"ბილეთი: თბილისი-ამსტერდამი",
            "Model":"1",
            "Quantity":1,
            "Amount":250,
            "ImageUrl":"http://www.picz.ge/img/s4/1811/20/5/56f04b4e03d4.png"
         },
         {  
            "Title":"Samsung",
            "Model":"s8",
            "Quantity":1,
            "Amount":1500,
            "ImageUrl":"http://www.picz.ge/img/s3/1811/20/c/cdfb5edfa323.png"
         },
         {  
            "Title":"Motorola",
            "Model":"v3",
            "Quantity":2,
            "Amount":25,
            "ImageUrl":"http://www.picz.ge/img/s1/1811/20/3/35b1d9130ba7.png"
         },
         {  
            "Title":"ტრანსპორტირება",
            "Model":"",
            "Quantity":1,
            "Amount":30,
            "ImageUrl":"http://www.picz.ge/img/s3/1811/20/2/2b974ea2e14c.png"
         }
      ],
      "Secret":"a0228e20-b654-4f7b-80a6-925e77f39f32"
   }
}
დაბრუნებული პასუხის ნიმუში:
{  
   "data":{  
      "qrCodeId":"98c89f11-18cb-497f-a52a-f145ace4ff69",
      "orderId":"11111",
      "redirectUrl":”https://testapi.spacebank.ge/api/v1/qr?data=98c89f11-18cb-
497f-a52a-f145ace4ff69&type=OnlineInstallment”,
      "qrCodeViewUrl":"https://testapi.spacebank.ge/api/v1/qr/qrcodeview?
data=81727272-3853-4f21-aa35-e87dd9727933&type=OnlineInstallment"

Davit Buachidze 4/9

481101344.docx
   },
   "status":{  
      "code":1,
      "message":null
   }
}
CreateQr -QR კოდის ნიმუში:

Davit Buachidze 5/9

481101344.docx
 Checkstatus
Checkstatus მეთოდი გამოიყენება SPACE-ის სისტემაში მერჩნტის მიერ გადაწოდებული Order ID-ის
ქვეშ შექმნილი განაცხადის სტატუსის გასაგებად.

გამოძახების მისამართი:
სატესტო გარემო: https://testapi.spacebank.ge/api/v1/loans/checkstatus
რეალური გარემო:
Method: GET

Checkstatus Requet:
Checkstatus მოთხოვნის პარამეტრები:

Property Name Data Mand Description

Type atory
MerchantName Y მერჩანტის დასახელება (უნდა ემთხვეოდეს SPACE-ს
სისტემაში გაწერილ მნიშვნელობას.
OrderId Y განაცხადის იდენტიფიკატორი მერჩანტის სისტემაში
Secret Y სფეისის მიერ მერჩანტისთვის მიწოდებული საიდუმლო
გასაღები. მუდმივია ყველა განაცხადისთვის.

Checkstatus Response:
მეთოდი აბრუნებს “data” და „status“ ობიექტს:

დაბრუნებული „data“ ობიექტის პარამეტრები:

Property Name Data Man Description

Type d
atory
orderId Y მერჩანტის მიერ მოწოდებული ორდერის id
status status Y განაცხადის სტატუსი(გაცემული, უარყოფილი, სხვა...)

status ობიექტის მნიშვნელობები:

1 დამტკიცებული
2 გაცემული
7 დახურული (კლიენტის მიერ)
10 უარყოფილი (სისტემის მიერ)

დაბრუნებული „status“ ობიექტის პარამეტრები:

Property Name Data Mand Description

Type atory

Davit Buachidze 6/9

481101344.docx
code code Y განსაზღვრავს მოთხოვნის წარმატებით განხორციელბის
სტატუს.
message Y განმარტავს მოთხოვნის შეცდომაზე გასვლის მიზეზს.

code ობიექტის მნიშვნელობები:

0 ზოგადი/გაუთვალისწინებელი შეცდომა
1 წარმატებული
1023 განვადება ვერ მოიძებნა
1505 არასწორი გასაღები
1506 არასწორი მერჩანტის სახელი

Checkstatus გამოძახების ნიმუში:

https://testapi.spacebank.ge/api/v1/loans/checkstatus?
merchantname=Megamall&orderId=555&secret=a0228e20-b654-4f7b-80a6-925e77f39f32

დაბრუნებული პასუხის ნიმუში:

{
"data": {
"orderId": "555",
"status": 7
},
"status": {
"code": 1,
"message": null
}
}

Davit Buachidze 7/9

481101344.docx
განვადების გაუქმების განაცხადის რეგისტრაციის მეთოდი -
InstalmentCancellationApplication
განვადების გაუქმებისთვის გამოიყენება სერვისი, რომელის საშუალებითაც ხდება განვადების ნაწილობრივი ან
სრული გაუქმება.

გამოძახების მისამართი:
სატესტო გარემო: https://testapi.spacebank.ge/api/v1/loans/installments/cancel
რეალური გარემო:
Method: POST

1.
Requet:
Property Name Data Mand Description
Type atory
MerchantName String Y მერჩანტის დასახელება (უნდა ემთხვეოდეს SPACE-ს
სისტემაში გაწერილ მნიშვნელობას.
OrderId String Y განაცხადის იდენტიფიკატორი მერჩანტის სისტემაში
Secret String Y სფეისის მიერ მერჩანტისთვის მიწოდებული
საიდუმლო გასაღები. მუდმივია ყველა
განაცხადისთვის.
CancellationType int Y 1 - Completely - სრული გაუქმება.
2 - Partially – ნაწილობრივი გაუქმება;
PartiallyCancellationAmount Money თუ CancellationType == Partially, მაშინ მოცემული
პარამეტრი სავალდებულოდ შესავსებია.
CancellationPurpose String Y გაუქმების მოთხოვნის მიზეზი
CancelledItems String N დაბრუნებული ან გასაუქმებელი ნივთები ან
მომსახურება ნაწილობრივი გაუქმების შემთხვევაში.
Response:
Property Name Data Mand Description
Type atory
orderId Y მერჩანტის მიერ მოწოდებული ორდერის id
status status Y

Status:
Code Message
1 დავალება მიღებულია (სრული გაუქმება)
1 დავალება მიღებულია (ნაწილობრივი გაუქმება)
1 დავალება მიღებულია (ნაწილობრივი გაუქმება ჩანაცვლდა სრული გაუქმებით)
9004 მიმდინარეობს წინა დავალების შესრულების პროცესი (სრული გაუქმება)
9005 სრული გაუქმების პროცესი უკვე შესრულებულია
9007 თანხის დაბრუნების პროცესი უკვე შესრულებულია (გაუქმდა გადარიცხვამდე)
ნაწილობრივი გაუქმების შემთხვევაში, აუცილებლად მისათითებელია
9008 კორექტირების თანხა.
9009 მოცემულ თანხაზე ნებადართულია მხოლოდ განვადების სრული გაუქმება

Davit Buachidze 8/9

481101344.docx
9010 ჩანაწერი არ მოიძებნა
9013 მიმდინარეობს პროცესინგი. სცადეთ მოგვიანებით
9014 შეუსაბამო კომბინაცია (InstallmentCancelType, OrderCorrectionAmount)
განვადების გაუქმების ვადა ამოწურულია, დამატებითი ინფორმაციისთვის
9018 მოგვმართეთ მეილზე: supportinstallment@space.ge
1505 არასწორი გასაღები
1506 არასწორი სახელი

InstalmentCancellationApplication გამოძახების ნიმუში:

URL: იხ. ზემოთ
{
"merchantName": "Megamall",
"orderId": "tako2019040238591",
"orderCorrection": 101,
"secret": "a0228e20-b654-4f7b-80a6-925e77f39f32",
"installmentCancelType": 1,
"purpose": "მარაგი ამოიწურა",
"canceledItems": "Nokia 8 SIROCCO UA BLACK, 1 ცალი, ერთეულის ფასი: 250.00 ლარი, ჯამური
ფასი: 250.00 ლარი"
}
დაბრუნებული პასუხის ნიმუში:
{
"data": {
"orderId": "tako2019040238591"
},
"status": {
"code": 1,
"message": "დავალება მიღებულია (სრული გაუქმება)"
}
}

Davit Buachidze 9/9

481101344.docx